# SimpleAMS MCP by usefulapi

> SimpleAMS MCP by usefulapi is a freemium MCP server for sales and crm. Hosted MCP server connecting AI assistants to SimpleAMS insurance agency records. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/simpleams/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/simpleams
- **MCP Registry name:** io.usefulapi/simpleams
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-19

## About

The server lets an AI client read and change records in a SimpleAMS insurance agency account, covering clients, policies, leads, agents, carriers, documents and commission transactions. It runs remotely, so there is nothing to install locally; you sign in through a login page with your own SimpleAMS REST API key, and the server then calls the SimpleAMS API with your access.

The toolset is 32 tools, 16 read-only and 12 that create or update data, plus meta tools for usage and subscriptions. Writes such as importing a carrier commission statement of up to 700 lines or uploading a file of up to 10 MB are handled through the same paths the SimpleAMS app uses, and the README says clients should confirm write calls before they run.

The server suits insurance agency staff who already use SimpleAMS and want to ask an assistant for renewals, lead creation or commission lookups. It is an independent usefulapi service, not an official SimpleAMS product, and requires a SimpleAMS plan that includes REST API access (Manager or higher).

## Features

- **Read agency records:** Lists and fetches clients, policies, leads, agents, carriers, documents and commission transactions.
- **Create and update records:** Adds or edits clients, policies, leads, agents and carriers using the fields the tool expects.
- **Document upload and download:** Attaches PDF, Office, text or image files to a client, policy, lead or carrier, and downloads small files directly.
- **Commission statement import:** Imports a carrier statement of up to 700 lines in one call, which then waits for Auto-Match in the app.
- **Hosted remote connection:** Connects over Streamable HTTP with OAuth login, so clients such as Claude, ChatGPT, Cursor and VS Code need only the URL.
- **Usage metering:** Reports calls used against the monthly limit and offers paid Pro and Pro+ plans with Stripe checkout.

## Good for

- Find clients whose policies renew within the next 30 days before a call
- Create a lead for a new prospect and assign it to an agent
- Review commission transactions for one carrier over a date range
- Attach a signed application to a client record
- Import a carrier commission statement for review

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http simpleams https://simpleams.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://simpleams.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "simpleams": {
      "url": "https://simpleams.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "simpleams": {
      "type": "http",
      "url": "https://simpleams.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "simpleams": {
      "serverUrl": "https://simpleams.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://simpleams.usefulapi.io/mcp
```

Enter a Name (for example "SimpleAMS MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "simpleams": {
      "type": "http",
      "url": "https://simpleams.usefulapi.io/mcp"
    }
  }
}
```

## Tools

16 of 28 tools say they're read-only. 12 of 28 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `simpleams_get_me` (says read-only): Show the user the API key belongs to and the key's permissions. Use it first to confirm the key works. SimpleAMS API: GET /me.
- `simpleams_list_clients` (says read-only): List clients the key can see, with optional search and filters. Social Security numbers are never returned. SimpleAMS API: GET /clients.
- `simpleams_get_client` (says read-only): Get one client, including phones, addresses and dependents. SimpleAMS API: GET /clients/{id}.
- `simpleams_create_client` (says it can change data): Create a client. Required: first_name, last_name, client_type. Add other fields in fields. Creating runs the same audit, notification and webhook steps as the app. SimpleAMS API: POST /clients.
- `simpleams_update_client` (says it can change data): Update a client. Send only the fields to change in fields; other fields keep their values. SimpleAMS API: PUT /clients/{id}.
- `simpleams_list_policies` (says read-only): List policies with optional search and filters. SimpleAMS API: GET /policies.
- `simpleams_get_policy` (says read-only): Get one policy. SimpleAMS API: GET /policies/{id}.
- `simpleams_create_policy` (says it can change data): Create a policy. Required: client_id, agent_id, carrier_id, policy_number, policy_status, effective_date (yyyy-mm-dd). Creating runs the same renewal and commission processing as the app. SimpleAMS API: POST /policies.
- `simpleams_update_policy` (says it can change data): Update a policy. Send only the fields to change in fields. Updating runs the same renewal and commission processing as the app. SimpleAMS API: PUT /policies/{id}.
- `simpleams_list_leads` (says read-only): List leads with optional search and filters, including date range. SimpleAMS API: GET /leads.
- `simpleams_get_lead` (says read-only): Get one lead. SimpleAMS API: GET /leads/{id}.
- `simpleams_create_lead` (says it can change data): Create a lead. Required: first_name, last_name, status. Paid-marketing fields (lead_cost, marketing_platform, marketing_platform_other) go in fields. SimpleAMS API: POST /leads.
- `simpleams_update_lead` (says it can change data): Update a lead. Send only the fields to change in fields. SimpleAMS API: PUT /leads/{id}.
- `simpleams_list_agents` (says read-only): List agents with optional search and status filter. Social Security numbers and dates of birth are never returned. SimpleAMS API: GET /agents.
- `simpleams_get_agent` (says read-only): Get one agent. SimpleAMS API: GET /agents/{id}.
- `simpleams_create_agent` (says it can change data): Create an agent. Required: first_name, last_name, email, phone_direct, agent_code, status, address (city, state, zip_code), system_access_option (none, create or link). Other fields go in fields. SimpleAMS API: POST /agents.
- `simpleams_update_agent` (says it can change data): Update an agent. Send only the fields to change in fields. SimpleAMS API: PUT /agents/{id}.
- `simpleams_list_carriers` (says read-only): List insurance carriers with optional search and status filter. SimpleAMS API: GET /carriers.
- `simpleams_get_carrier` (says read-only): Get one carrier. SimpleAMS API: GET /carriers/{id}.
- `simpleams_create_carrier` (says it can change data): Create a carrier. Required: name, status (Active or Inactive). Other fields go in fields. SimpleAMS API: POST /carriers.
- `simpleams_update_carrier` (says it can change data): Update a carrier. Send only the fields to change in fields. SimpleAMS API: PUT /carriers/{id}.
- `simpleams_list_documents` (says read-only): List documents with optional filters: collection, search, and the record they attach to (related_type and related_id). SimpleAMS API: GET /documents.
- `simpleams_get_document` (says read-only): Get the details of one document (name, type, size, the record it attaches to). SimpleAMS API: GET /documents/{id}.
- `simpleams_download_document` (says read-only): Download one document. Returns the content as base64 when it is at most 32768 bytes; larger files must be downloaded in the app. SimpleAMS API: GET /documents/{id}/download.
- `simpleams_upload_document` (says it can change data): Attach a file to a client, policy, lead or carrier. Send the file as base64 in content_base64 (10 MB maximum). Allowed types: pdf, doc, docx, xls, xlsx, ppt, pptx, txt, csv, jpg, jpeg, png. policy_id is allowed only when uploading to a client. SimpleAMS API: POST /{type}/{id}/documents.
- `simpleams_list_commissions` (says read-only): List commission transactions (read-only) with filters for agent, carrier, policy, type, status, source and date range. SimpleAMS API: GET /commissions.
- `simpleams_get_commission` (says read-only): Get one commission transaction (read-only). SimpleAMS API: GET /commissions/{id}.
- `simpleams_import_commission_statement` (says it can change data): Import a carrier commission statement with all its lines in one call. The statement arrives as Pending Review with unmatched lines; the user runs Auto-Match in the app. At most 700 lines per call. The key's user needs the Import Commission Statements permission. SimpleAMS API: POST /commission-statements.

## FAQ

### Is this an official SimpleAMS product?

No. usefulapi is an independent service and is not affiliated with or endorsed by SimpleAMS.

### What do I need to connect?

The login page asks for your SimpleAMS REST API key, which you create under Settings, API & Webhooks, Manage API Keys. The REST API needs the Manager plan or higher.

### Can the AI change my SimpleAMS data?

Yes, if you approve it. 12 of the 28 SimpleAMS tools can create or change data, and the other 16 are read-only. Most MCP clients ask for approval before a tool call runs.

### What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each subscription covers this server only.

### Is SimpleAMS MCP by usefulapi free?

SimpleAMS MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add SimpleAMS MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http simpleams https://simpleams.usefulapi.io/mcp

### What are the best alternatives to SimpleAMS MCP by usefulapi?

The closest alternatives to SimpleAMS MCP by usefulapi are EstatePrime MCP by usefulapi and Spotler CRM MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [EstatePrime MCP by usefulapi](https://ai-powered.com/mcp/estateprime-mcp-by-usefulapi): EstatePrime MCP by usefulapi is a freemium MCP server for sales and crm.
- [Spotler CRM MCP by usefulapi](https://ai-powered.com/mcp/spotler-crm-mcp-by-usefulapi): Spotler CRM MCP by usefulapi is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/simpleams-mcp-by-usefulapi
