SimpleAMS MCP by usefulapi is an MCP server published by io.usefulapi, hosted at simpleams.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 28 tools, including simpleams_get_me, simpleams_list_clients, simpleams_get_client, simpleams_create_client, simpleams_update_client.
Read clients, policies, leads and commissions; create and update records in SimpleAMS.
4,137 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "simpleams_get_me",
"title": "Check the API key",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Check the API key",
"readOnlyHint": true
}
}List clients the key can see, with optional search and filters. Social Security numbers are never returned. SimpleAMS API: GET /clients.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| search | string | Search text. |
| status | string | Client status, for example Active. |
| per_page | integer | Results per page, 1-100 (default 25). |
| client_type | string | Client type, for example Individual. |
{
"name": "simpleams_list_clients",
"title": "List clients",
"description": "List clients the key can see, with optional search and filters. Social Security numbers are never returned. SimpleAMS API: GET /clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search text."
},
"status": {
"type": "string",
"description": "Client status, for example Active."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"client_type": {
"type": "string",
"description": "Client type, for example Individual."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}Get one client, including phones, addresses and dependents. SimpleAMS API: GET /clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | integer | The client id. |
{
"name": "simpleams_get_client",
"title": "Get a client",
"description": "Get one client, including phones, addresses and dependents. SimpleAMS API: GET /clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The client id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a client",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| last_name * | string | |
| first_name * | string | |
| client_type * | string | Client type, for example Individual. |
{
"name": "simpleams_create_client",
"title": "Create a client",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"first_name",
"last_name",
"client_type"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"client_type": {
"type": "string",
"description": "Client type, for example Individual."
}
}
},
"annotations": {
"title": "Create a client",
"readOnlyHint": false,
"destructiveHint": false
}
}Update a client. Send only the fields to change in fields; other fields keep their values. SimpleAMS API: PUT /clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| client_id * | integer | The client id. |
{
"name": "simpleams_update_client",
"title": "Update a client",
"description": "Update a client. Send only the fields to change in fields; other fields keep their values. SimpleAMS API: PUT /clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The client id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a client",
"readOnlyHint": false,
"idempotentHint": true
}
}List policies with optional search and filters. SimpleAMS API: GET /policies.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| search | string | Search text. |
| status | string | Policy status filter. |
| agent_id | integer | Only policies of this agent id. |
| per_page | integer | Results per page, 1-100 (default 25). |
| client_id | integer | Only policies of this client id. |
| carrier_id | integer | Only policies with this carrier id. |
{
"name": "simpleams_list_policies",
"title": "List policies",
"description": "List policies with optional search and filters. SimpleAMS API: GET /policies.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search text."
},
"status": {
"type": "string",
"description": "Policy status filter."
},
"agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only policies of this agent id.",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only policies of this client id.",
"exclusiveMinimum": 0
},
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only policies with this carrier id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List policies",
"readOnlyHint": true
}
}Get one policy. SimpleAMS API: GET /policies/{id}.
| Parameter | Type | Description |
|---|---|---|
| policy_id * | integer | The policy id. |
{
"name": "simpleams_get_policy",
"title": "Get a policy",
"description": "Get one policy. SimpleAMS API: GET /policies/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"policy_id"
],
"properties": {
"policy_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The policy id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a policy",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| agent_id * | integer | The agent id. |
| client_id * | integer | The client id. |
| carrier_id * | integer | The carrier id. |
| policy_number * | string | |
| policy_status * | string | |
| effective_date * | string |
{
"name": "simpleams_create_policy",
"title": "Create a policy",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"agent_id",
"carrier_id",
"policy_number",
"policy_status",
"effective_date"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The agent id.",
"exclusiveMinimum": 0
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The client id.",
"exclusiveMinimum": 0
},
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The carrier id.",
"exclusiveMinimum": 0
},
"policy_number": {
"type": "string"
},
"policy_status": {
"type": "string"
},
"effective_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "Create a policy",
"readOnlyHint": false,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| policy_id * | integer | The policy id. |
{
"name": "simpleams_update_policy",
"title": "Update a policy",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"policy_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"policy_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The policy id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a policy",
"readOnlyHint": false,
"idempotentHint": true
}
}List leads with optional search and filters, including date range. SimpleAMS API: GET /leads.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| state | string | State code. |
| search | string | Search text. |
| status | string | Lead status filter. |
| date_to | string | |
| per_page | integer | Results per page, 1-100 (default 25). |
| zip_code | string | |
| date_from | string | |
| lead_type | string | |
| lead_source | string | |
| assigned_agent_id | integer |
Get one lead. SimpleAMS API: GET /leads/{id}.
| Parameter | Type | Description |
|---|---|---|
| lead_id * | integer | The lead id. |
{
"name": "simpleams_get_lead",
"title": "Get a lead",
"description": "Get one lead. SimpleAMS API: GET /leads/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lead_id"
],
"properties": {
"lead_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The lead id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a lead",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| status * | string | |
| last_name * | string | |
| first_name * | string |
{
"name": "simpleams_create_lead",
"title": "Create a lead",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"first_name",
"last_name",
"status"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
}
}
},
"annotations": {
"title": "Create a lead",
"readOnlyHint": false,
"destructiveHint": false
}
}Update a lead. Send only the fields to change in fields. SimpleAMS API: PUT /leads/{id}.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| lead_id * | integer | The lead id. |
{
"name": "simpleams_update_lead",
"title": "Update a lead",
"description": "Update a lead. Send only the fields to change in fields. SimpleAMS API: PUT /leads/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lead_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"lead_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The lead id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a lead",
"readOnlyHint": false,
"idempotentHint": true
}
}List agents with optional search and status filter. Social Security numbers and dates of birth are never returned. SimpleAMS API: GET /agents.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| search | string | Search text. |
| status | string | Agent status filter. |
| per_page | integer | Results per page, 1-100 (default 25). |
{
"name": "simpleams_list_agents",
"title": "List agents",
"description": "List agents with optional search and status filter. Social Security numbers and dates of birth are never returned. SimpleAMS API: GET /agents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search text."
},
"status": {
"type": "string",
"description": "Agent status filter."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List agents",
"readOnlyHint": true
}
}Get one agent. SimpleAMS API: GET /agents/{id}.
| Parameter | Type | Description |
|---|---|---|
| agent_id * | integer | The agent id. |
{
"name": "simpleams_get_agent",
"title": "Get an agent",
"description": "Get one agent. SimpleAMS API: GET /agents/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agent_id"
],
"properties": {
"agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The agent id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an agent",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| status * | string | |
| address * | object | |
| last_name * | string | |
| agent_code * | string | |
| first_name * | string | |
| phone_direct * | string | |
| system_access_option * | string | one of ["none","create","link"] |
Update an agent. Send only the fields to change in fields. SimpleAMS API: PUT /agents/{id}.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| agent_id * | integer | The agent id. |
{
"name": "simpleams_update_agent",
"title": "Update an agent",
"description": "Update an agent. Send only the fields to change in fields. SimpleAMS API: PUT /agents/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agent_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The agent id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update an agent",
"readOnlyHint": false,
"idempotentHint": true
}
}List insurance carriers with optional search and status filter. SimpleAMS API: GET /carriers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| search | string | Search text. |
| status | string | Active or Inactive. |
| per_page | integer | Results per page, 1-100 (default 25). |
{
"name": "simpleams_list_carriers",
"title": "List carriers",
"description": "List insurance carriers with optional search and status filter. SimpleAMS API: GET /carriers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search text."
},
"status": {
"type": "string",
"description": "Active or Inactive."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List carriers",
"readOnlyHint": true
}
}Get one carrier. SimpleAMS API: GET /carriers/{id}.
| Parameter | Type | Description |
|---|---|---|
| carrier_id * | integer | The carrier id. |
{
"name": "simpleams_get_carrier",
"title": "Get a carrier",
"description": "Get one carrier. SimpleAMS API: GET /carriers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"carrier_id"
],
"properties": {
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The carrier id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a carrier",
"readOnlyHint": true
}
}Create a carrier. Required: name, status (Active or Inactive). Other fields go in fields. SimpleAMS API: POST /carriers.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| status * | string | one of ["Active","Inactive"] |
{
"name": "simpleams_create_carrier",
"title": "Create a carrier",
"description": "Create a carrier. Required: name, status (Active or Inactive). Other fields go in fields. SimpleAMS API: POST /carriers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"status"
],
"properties": {
"name": {
"type": "string"
},
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"enum": [
"Active",
"Inactive"
],
"type": "string"
}
}
},
"annotations": {
"title": "Create a carrier",
"readOnlyHint": false,
"destructiveHint": false
}
}Update a carrier. Send only the fields to change in fields. SimpleAMS API: PUT /carriers/{id}.
| Parameter | Type | Description |
|---|---|---|
| fields | object | Other fields, named as the SimpleAMS API names them (same rules as the app forms). |
| carrier_id * | integer | The carrier id. |
{
"name": "simpleams_update_carrier",
"title": "Update a carrier",
"description": "Update a carrier. Send only the fields to change in fields. SimpleAMS API: PUT /carriers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"carrier_id"
],
"properties": {
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The carrier id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a carrier",
"readOnlyHint": false,
"idempotentHint": true
}
}List documents with optional filters: collection, search, and the record they attach to (related_type and related_id). SimpleAMS API: GET /documents.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| search | string | Search text. |
| per_page | integer | Results per page, 1-100 (default 25). |
| collection | string | |
| related_id | integer | |
| related_type | string | one of ["client","policy","lead","carrier"] |
{
"name": "simpleams_list_documents",
"title": "List documents",
"description": "List documents with optional filters: collection, search, and the record they attach to (related_type and related_id). SimpleAMS API: GET /documents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Search text."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"collection": {
"type": "string"
},
"related_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"related_type": {
"enum": [
"client",
"policy",
"lead",
"carrier"
],
"type": "string"
}
}
},
"annotations": {
"title": "List documents",
"readOnlyHint": true
}
}Get the details of one document (name, type, size, the record it attaches to). SimpleAMS API: GET /documents/{id}.
| Parameter | Type | Description |
|---|---|---|
| document_id * | integer | The document id. |
{
"name": "simpleams_get_document",
"title": "Get a document",
"description": "Get the details of one document (name, type, size, the record it attaches to). SimpleAMS API: GET /documents/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The document id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| document_id * | integer | The document id. |
{
"name": "simpleams_download_document",
"title": "Download a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The document id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Download a document",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Display name. |
| file_name * | string | File name with extension, for example application.pdf. |
| policy_id | integer | Only when record_type is clients. |
| record_id * | integer | The record id. |
| collection | string | |
| description | string | |
| record_type * | string | one of ["clients","policies","leads","carriers"] |
| content_base64 * | string | The file content, base64 encoded. |
{
"name": "simpleams_upload_document",
"title": "Upload a document",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"record_type",
"record_id",
"file_name",
"content_base64"
],
"properties": {
"name": {
"type": "string",
"description": "Display name."
},
"file_name": {
"type": "string",
"description": "File name with extension, for example application.pdf."
},
"policy_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only when record_type is clients.",
"exclusiveMinimum": 0
},
"record_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The record id.",
"exclusiveMinimum": 0
},
"collection": {
"type": "string"
},
"description": {
"type": "string"
},
"record_type": {
"enum": [
"clients",
"policies",
"leads",
"carriers"
],
"type": "string"
},
"content_base64": {
"type": "string",
"description": "The file content, base64 encoded."
}
}
},
"annotations": {
"title": "Upload a document",
"readOnlyHint": false,
"destructiveHint": false
}
}List commission transactions (read-only) with filters for agent, carrier, policy, type, status, source and date range. SimpleAMS API: GET /commissions.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| source | string | |
| status | string | |
| date_to | string | |
| agent_id | integer | |
| per_page | integer | Results per page, 1-100 (default 25). |
| date_from | string | |
| policy_id | integer | |
| carrier_id | integer | |
| beneficiary_type | string | |
| transaction_type | string |
Get one commission transaction (read-only). SimpleAMS API: GET /commissions/{id}.
| Parameter | Type | Description |
|---|---|---|
| commission_id * | integer | The commission transaction id. |
{
"name": "simpleams_get_commission",
"title": "Get a commission transaction",
"description": "Get one commission transaction (read-only). SimpleAMS API: GET /commissions/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"commission_id"
],
"properties": {
"commission_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The commission transaction id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a commission transaction",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| lines * | array | |
| notes | string | |
| carrier_id * | integer | The carrier id. |
| period_end * | string | |
| period_start * | string | |
| received_date | string | |
| reported_total * | number | |
| statement_date * | string | |
| statement_name * | string | |
| statement_number | string |
Tools for SimpleAMS, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of my clients have a policy renewing in the next 30 days?"; "Create a new lead for Jane Smith from the spring campaign and assign it to agent 12."; "Show the commission transactions for carrier 5 from last month.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes SimpleAMS data. Free plan: 50 tool calls per month. Run simpleams_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run simpleams_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run simpleams_upgrade without a plan: it returns both plans, each with a payment link for the user to open. simpleams_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "simpleams_list_leads",
"title": "List leads",
"description": "List leads with optional search and filters, including date range. SimpleAMS API: GET /leads.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"state": {
"type": "string",
"description": "State code."
},
"search": {
"type": "string",
"description": "Search text."
},
"status": {
"type": "string",
"description": "Lead status filter."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"zip_code": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"lead_type": {
"type": "string"
},
"lead_source": {
"type": "string"
},
"assigned_agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List leads",
"readOnlyHint": true
}
}{
"name": "simpleams_create_agent",
"title": "Create an agent",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"first_name",
"last_name",
"email",
"phone_direct",
"agent_code",
"status",
"address",
"system_access_option"
],
"properties": {
"email": {
"type": "string"
},
"fields": {
"type": "object",
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"status": {
"type": "string"
},
"address": {
"type": "object",
"required": [
"city",
"state",
"zip_code"
],
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip_code": {
"type": "string"
}
}
},
"last_name": {
"type": "string"
},
"agent_code": {
"type": "string"
},
"first_name": {
"type": "string"
},
"phone_direct": {
"type": "string"
},
"system_access_option": {
"enum": [
"none",
"create",
"link"
],
"type": "string"
}
}
},
"annotations": {
"title": "Create an agent",
"readOnlyHint": false,
"destructiveHint": false
}
}{
"name": "simpleams_list_commissions",
"title": "List commission transactions",
"description": "List commission transactions (read-only) with filters for agent, carrier, policy, type, status, source and date range. SimpleAMS API: GET /commissions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"source": {
"type": "string"
},
"status": {
"type": "string"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"agent_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"policy_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"beneficiary_type": {
"type": "string"
},
"transaction_type": {
"type": "string"
}
}
},
"annotations": {
"title": "List commission transactions",
"readOnlyHint": true
}
}| Unique per carrier. |
| reported_policy_count | integer |
{
"name": "simpleams_import_commission_statement",
"title": "Import a commission statement",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"carrier_id",
"statement_name",
"period_start",
"period_end",
"statement_date",
"reported_total",
"lines"
],
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"required": [
"policy_number",
"amount"
],
"properties": {
"rate": {
"type": "number"
},
"amount": {
"type": "number",
"description": "Commission amount. Negative for a chargeback."
},
"premium": {
"type": "number"
},
"line_type": {
"enum": [
"commission",
"advance",
"as_earned",
"renewal",
"override",
"bonus",
"chargeback",
"adjustment",
"fee",
"unknown"
],
"type": "string",
"description": "Default commission."
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"insured_name": {
"type": "string"
},
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"product_name": {
"type": "string"
},
"policy_number": {
"type": "string",
"description": "Carrier policy number."
},
"agent_identifier": {
"type": "string"
},
"transaction_code": {
"type": "string"
},
"transaction_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"maxItems": 700,
"minItems": 1
},
"notes": {
"type": "string"
},
"carrier_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The carrier id.",
"exclusiveMinimum": 0
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"received_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reported_total": {
"type": "number"
},
"statement_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"statement_name": {
"type": "string"
},
"statement_number": {
"type": "string",
"description": "Unique per carrier."
},
"reported_policy_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
}
},
"annotations": {
"title": "Import a commission statement",
"readOnlyHint": false,
"destructiveHint": false
}
}