SimpleAMS MCP by usefulapi
io.usefulapi/simpleams · v1.1.0 · MCP 2025-11-25
Read clients, policies, leads and commissions; create and update records in SimpleAMS.
Reachability
reachable
checked 2026-11-21 05:32 UTC
Registry status active
Tools pinned 28
8faffc7a5967
Tools last changed
unchanged since first capture 2026-11-19
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Website
https://usefulapi.io/simpleams/
Remote endpoints
https://simpleams.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-19 05:30 | first capture | 28 tools pinned |
Pinned tool definitions (28)
| Tool | Description |
|---|---|
| simpleams_get_me | 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 | List clients the key can see, with optional search and filters. Social Security numbers are never returned. SimpleAMS API: GET /clients. |
| simpleams_get_client | Get one client, including phones, addresses and dependents. SimpleAMS API: GET /clients/{id}. |
| simpleams_create_client | 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 | Update a client. Send only the fields to change in fields; other fields keep their values. SimpleAMS API: PUT /clients/{id}. |
| simpleams_list_policies | List policies with optional search and filters. SimpleAMS API: GET /policies. |
| simpleams_get_policy | Get one policy. SimpleAMS API: GET /policies/{id}. |
| simpleams_create_policy | 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 | 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 | List leads with optional search and filters, including date range. SimpleAMS API: GET /leads. |
| simpleams_get_lead | Get one lead. SimpleAMS API: GET /leads/{id}. |
| simpleams_create_lead | 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 | Update a lead. Send only the fields to change in fields. SimpleAMS API: PUT /leads/{id}. |
| simpleams_list_agents | 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 | Get one agent. SimpleAMS API: GET /agents/{id}. |
| simpleams_create_agent | 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 | Update an agent. Send only the fields to change in fields. SimpleAMS API: PUT /agents/{id}. |
| simpleams_list_carriers | List insurance carriers with optional search and status filter. SimpleAMS API: GET /carriers. |
| simpleams_get_carrier | Get one carrier. SimpleAMS API: GET /carriers/{id}. |
| simpleams_create_carrier | Create a carrier. Required: name, status (Active or Inactive). Other fields go in fields. SimpleAMS API: POST /carriers. |
| simpleams_update_carrier | Update a carrier. Send only the fields to change in fields. SimpleAMS API: PUT /carriers/{id}. |
| simpleams_list_documents | 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 | Get the details of one document (name, type, size, the record it attaches to). SimpleAMS API: GET /documents/{id}. |
| simpleams_download_document | 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 | 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... |
| simpleams_list_commissions | List commission transactions (read-only) with filters for agent, carrier, policy, type, status, source and date range. SimpleAMS API: GET /commissions. |
| simpleams_get_commission | Get one commission transaction (read-only). SimpleAMS API: GET /commissions/{id}. |
| simpleams_import_commission_statement | 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... |
Get alerted when this changes.
Email the moment io.usefulapi/simpleams drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/simpleams)
Maintain this server? Add the badge to your README. It links your users to this live status page.