SimpleAMS MCP by usefulapi
Read clients, policies, leads and commissions; create and update records in SimpleAMS.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWsimpleams_import_commission_statement에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"simpleams": {
"url": "https://simpleams.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://simpleams.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (28)
🟢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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_clients(search, client_type, status, page, per_page)
List clients the key can see, with optional search and filters. Social Security numbers are never returned. SimpleAMS API: GET /clients.
입력 스키마
{
"type": "object",
"properties": {
"search": {
"description": "Search text.",
"type": "string"
},
"client_type": {
"description": "Client type, for example Individual.",
"type": "string"
},
"status": {
"description": "Client status, for example Active.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_client(client_id)
Get one client, including phones, addresses and dependents. SimpleAMS API: GET /clients/{id}.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The client id."
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_create_client(first_name, last_name, client_type, fields)
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.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"client_type": {
"type": "string",
"description": "Client type, for example Individual."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"first_name",
"last_name",
"client_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_update_client(client_id, fields)
Update a client. Send only the fields to change in fields; other fields keep their values. SimpleAMS API: PUT /clients/{id}.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The client id."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"client_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_policies(search, status, agent_id, carrier_id, client_id, ...)
List policies with optional search and filters. SimpleAMS API: GET /policies.
입력 스키마
{
"type": "object",
"properties": {
"search": {
"description": "Search text.",
"type": "string"
},
"status": {
"description": "Policy status filter.",
"type": "string"
},
"agent_id": {
"description": "Only policies of this agent id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"carrier_id": {
"description": "Only policies with this carrier id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"client_id": {
"description": "Only policies of this client id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_policy(policy_id)
Get one policy. SimpleAMS API: GET /policies/{id}.
입력 스키마
{
"type": "object",
"properties": {
"policy_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The policy id."
}
},
"required": [
"policy_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_create_policy(client_id, agent_id, carrier_id, policy_number, policy_status, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"client_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The client id."
},
"agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The agent id."
},
"carrier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The carrier id."
},
"policy_number": {
"type": "string"
},
"policy_status": {
"type": "string"
},
"effective_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"client_id",
"agent_id",
"carrier_id",
"policy_number",
"policy_status",
"effective_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_update_policy(policy_id, fields)
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}.
입력 스키마
{
"type": "object",
"properties": {
"policy_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The policy id."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"policy_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_leads(search, status, assigned_agent_id, lead_source, lead_type, ...)
List leads with optional search and filters, including date range. SimpleAMS API: GET /leads.
입력 스키마
{
"type": "object",
"properties": {
"search": {
"description": "Search text.",
"type": "string"
},
"status": {
"description": "Lead status filter.",
"type": "string"
},
"assigned_agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"lead_source": {
"type": "string"
},
"lead_type": {
"type": "string"
},
"state": {
"description": "State code.",
"type": "string"
},
"zip_code": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_lead(lead_id)
Get one lead. SimpleAMS API: GET /leads/{id}.
입력 스키마
{
"type": "object",
"properties": {
"lead_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The lead id."
}
},
"required": [
"lead_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_create_lead(first_name, last_name, status, fields)
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.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"status": {
"type": "string"
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"first_name",
"last_name",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_update_lead(lead_id, fields)
Update a lead. Send only the fields to change in fields. SimpleAMS API: PUT /leads/{id}.
입력 스키마
{
"type": "object",
"properties": {
"lead_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The lead id."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"lead_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_agents(search, status, page, per_page)
List agents with optional search and status filter. Social Security numbers and dates of birth are never returned. SimpleAMS API: GET /agents.
입력 스키마
{
"type": "object",
"properties": {
"search": {
"description": "Search text.",
"type": "string"
},
"status": {
"description": "Agent status filter.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_agent(agent_id)
Get one agent. SimpleAMS API: GET /agents/{id}.
입력 스키마
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The agent id."
}
},
"required": [
"agent_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_create_agent(first_name, last_name, email, phone_direct, agent_code, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone_direct": {
"type": "string"
},
"agent_code": {
"type": "string"
},
"status": {
"type": "string"
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip_code": {
"type": "string"
}
},
"required": [
"city",
"state",
"zip_code"
]
},
"system_access_option": {
"type": "string",
"enum": [
"none",
"create",
"link"
]
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"first_name",
"last_name",
"email",
"phone_direct",
"agent_code",
"status",
"address",
"system_access_option"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_update_agent(agent_id, fields)
Update an agent. Send only the fields to change in fields. SimpleAMS API: PUT /agents/{id}.
입력 스키마
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The agent id."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"agent_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_carriers(search, status, page, per_page)
List insurance carriers with optional search and status filter. SimpleAMS API: GET /carriers.
입력 스키마
{
"type": "object",
"properties": {
"search": {
"description": "Search text.",
"type": "string"
},
"status": {
"description": "Active or Inactive.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_carrier(carrier_id)
Get one carrier. SimpleAMS API: GET /carriers/{id}.
입력 스키마
{
"type": "object",
"properties": {
"carrier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The carrier id."
}
},
"required": [
"carrier_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_create_carrier(name, status, fields)
Create a carrier. Required: name, status (Active or Inactive). Other fields go in fields. SimpleAMS API: POST /carriers.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"Active",
"Inactive"
]
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"name",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_update_carrier(carrier_id, fields)
Update a carrier. Send only the fields to change in fields. SimpleAMS API: PUT /carriers/{id}.
입력 스키마
{
"type": "object",
"properties": {
"carrier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The carrier id."
},
"fields": {
"description": "Other fields, named as the SimpleAMS API names them (same rules as the app forms).",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"carrier_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_documents(collection, search, related_type, related_id, page, ...)
List documents with optional filters: collection, search, and the record they attach to (related_type and related_id). SimpleAMS API: GET /documents.
입력 스키마
{
"type": "object",
"properties": {
"collection": {
"type": "string"
},
"search": {
"description": "Search text.",
"type": "string"
},
"related_type": {
"type": "string",
"enum": [
"client",
"policy",
"lead",
"carrier"
]
},
"related_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_document(document_id)
Get the details of one document (name, type, size, the record it attaches to). SimpleAMS API: GET /documents/{id}.
입력 스키마
{
"type": "object",
"properties": {
"document_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The document id."
}
},
"required": [
"document_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_download_document(document_id)
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.
입력 스키마
{
"type": "object",
"properties": {
"document_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The document id."
}
},
"required": [
"document_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_upload_document(record_type, record_id, file_name, content_base64, collection, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"record_type": {
"type": "string",
"enum": [
"clients",
"policies",
"leads",
"carriers"
]
},
"record_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record id."
},
"file_name": {
"type": "string",
"description": "File name with extension, for example application.pdf."
},
"content_base64": {
"type": "string",
"description": "The file content, base64 encoded."
},
"collection": {
"type": "string"
},
"name": {
"description": "Display name.",
"type": "string"
},
"description": {
"type": "string"
},
"policy_id": {
"description": "Only when record_type is clients.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"record_type",
"record_id",
"file_name",
"content_base64"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_list_commissions(agent_id, carrier_id, policy_id, transaction_type, beneficiary_type, ...)
List commission transactions (read-only) with filters for agent, carrier, policy, type, status, source and date range. SimpleAMS API: GET /commissions.
입력 스키마
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"carrier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"policy_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"transaction_type": {
"type": "string"
},
"beneficiary_type": {
"type": "string"
},
"status": {
"type": "string"
},
"source": {
"type": "string"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page, 1-100 (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢simpleams_get_commission(commission_id)
Get one commission transaction (read-only). SimpleAMS API: GET /commissions/{id}.
입력 스키마
{
"type": "object",
"properties": {
"commission_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The commission transaction id."
}
},
"required": [
"commission_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡simpleams_import_commission_statement(carrier_id, statement_name, period_start, period_end, statement_date, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"carrier_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The carrier id."
},
"statement_name": {
"type": "string"
},
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"statement_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reported_total": {
"type": "number"
},
"lines": {
"minItems": 1,
"maxItems": 700,
"type": "array",
"items": {
"type": "object",
"properties": {
"policy_number": {
"type": "string",
"description": "Carrier policy number."
},
"amount": {
"type": "number",
"description": "Commission amount. Negative for a chargeback."
},
"agent_identifier": {
"type": "string"
},
"insured_name": {
"type": "string"
},
"product_name": {
"type": "string"
},
"transaction_code": {
"type": "string"
},
"line_type": {
"description": "Default commission.",
"type": "string",
"enum": [
"commission",
"advance",
"as_earned",
"renewal",
"override",
"bonus",
"chargeback",
"adjustment",
"fee",
"unknown"
]
},
"premium": {
"type": "number"
},
"rate": {
"type": "number"
},
"period_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"period_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"transaction_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"policy_number",
"amount"
]
}
},
"statement_number": {
"description": "Unique per carrier.",
"type": "string"
},
"received_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reported_policy_count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notes": {
"type": "string"
}
},
"required": [
"carrier_id",
"statement_name",
"period_start",
"period_end",
"statement_date",
"reported_total",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거