NextAgency MCP by usefulapi
Read cases, contacts, tasks, notes and benefits; add cases, notes and tasks in NextAgency.
Should I use this
Quality & Safety
Findings (9)
- LOWin nextagency_list_case_custom_fields
- LOWin nextagency_list_case_benefits
- LOWin nextagency_list_case_tasks
- LOWin nextagency_get_case_task
- LOWin nextagency_get_case_note
- LOWin nextagency_find_contacts_by_phone
- LOWin nextagency_list_sub_agents
- LOWin nextagency_list_case_custom_fields
- LOWin nextagency_find_contacts_by_phone
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"nextagency": {
"url": "https://nextagency.usefulapi.io/mcp"
}
}
}Remote endpoints
https://nextagency.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (22)
🟢nextagency_get_profile
The NextAgency user the token acts as: id, name, email and role. Use it to check the connection.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_users(limit, offset)
The agency's users (brokers and staff): id, name, email, role. Use the id as assigned_to in nextagency_create_case_task.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_cases(sales_status, case_number, limit, offset)
The cases the token can see, one page at a time: id, case number, name, sales status, stage, owner, market segment. Filter by sales status (for example Prospect or Client) or by case number. Use the id with the other case tools.
Input Schema
{
"type": "object",
"properties": {
"sales_status": {
"description": "Only cases with this sales status, for example Client.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"case_number": {
"description": "Only the case with this number (the number the portal shows).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_search_cases(query, limit, offset)
Cases whose name, number or contact details match the query, one page at a time.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The search text, for example a surname or a case name."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_get_case(case_id)
One case by id: its details, status, stage, owner and addresses.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_contacts(case_id)
The contacts linked to one case, with the primary flag. Use nextagency_get_contact for one contact.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_employees(case_id, limit, offset)
The employees of one case (group business): name, employment type, start and termination dates, pay cycle.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_custom_fields(case_id, limit, offset)
The custom fields of one case, with their names and values.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_benefits(case_id, limit, offset)
The insurance benefits (policies) of one case: type, carrier and features.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_tasks(case_id, limit, offset)
The tasks of one case: title, stage, type, priority, due date and assignees.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_get_case_task(case_id, task_id)
One task of a case by id.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"task_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The task id (UUID), from nextagency_list_case_tasks."
}
},
"required": [
"case_id",
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_case_notes(case_id, limit, offset)
The notes of one case: title, body, pinned flag, author and assignees. Use nextagency_get_case_note for one note.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"case_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_get_case_note(case_id, note_id)
One note of a case by id, with its full body.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"note_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The note id (UUID), from nextagency_list_case_notes."
}
},
"required": [
"case_id",
"note_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_contacts(limit, offset)
The agency's contacts, one page at a time: name, emails, phone numbers and addresses.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_search_contacts(query, limit, offset)
Contacts whose name, email or details match the query, one page at a time.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The search text, for example a full name."
},
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_find_contacts_by_phone(phone_number)
The contacts that have this phone number. Enter the digits only, for example 5551234567.
Input Schema
{
"type": "object",
"properties": {
"phone_number": {
"type": "string",
"pattern": "^[0-9]{5,15}$",
"description": "The phone number, digits only."
}
},
"required": [
"phone_number"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_get_contact(contact_id)
One contact by id: name, emails, phone numbers and addresses.
Input Schema
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The contact id (UUID), from nextagency_list_contacts or nextagency_search_contacts."
}
},
"required": [
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_carriers(limit, offset)
The insurance carriers in the agency's list: name, states and contact details.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢nextagency_list_sub_agents(limit, offset)
The sub-agents (vendors and individual agents) of the agency.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Records per page, 1 to 50 (default 10).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"description": "Records to skip (default 0). Use next_offset from the last page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nextagency_create_case(name, first_name, last_name, email, phone_number, ...)
WRITE: create a new case. Give a name, or a first name for an individual (market_segment individual). The API checks the whole request first: an invalid request stores nothing. Returns the new case.
Input Schema
{
"type": "object",
"properties": {
"name": {
"description": "The case name (required unless market_segment is individual).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"first_name": {
"description": "First name (required for an individual).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone_number": {
"type": "string",
"pattern": "^[0-9+() .-]{5,30}$"
},
"sales_status": {
"description": "For example Prospect or Client.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"market_segment": {
"type": "string",
"enum": [
"individual",
"small_group",
"large_group"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nextagency_create_case_note(case_id, title, body, pinned)
WRITE: add a note to one case. Use the title for a short label and the body for the text. Returns the new note.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The note title."
},
"body": {
"description": "The note text.",
"type": "string",
"maxLength": 20000
},
"pinned": {
"description": "Pin the note to the case summary.",
"type": "boolean"
}
},
"required": [
"case_id",
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴nextagency_create_case_task(case_id, title, stage, type, priority, ...)
WRITE: add a task to one case. The due date uses the format of the vendor example: DD-MM-YYYY HH:MM AM UTC. assigned_to takes user ids from nextagency_list_users. Returns the new task.
Input Schema
{
"type": "object",
"properties": {
"case_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The case id (UUID), from nextagency_list_cases."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The task title."
},
"stage": {
"description": "The task stage, for example To Do.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"type": {
"description": "The task type, for example Other.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"priority": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"due": {
"description": "The due date, DD-MM-YYYY HH:MM AM UTC.",
"type": "string",
"minLength": 1,
"maxLength": 60
},
"body": {
"description": "The task text (HTML allowed).",
"type": "string",
"maxLength": 20000
},
"assigned_to": {
"description": "User ids to assign.",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
}
},
"required": [
"case_id",
"title"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence