NextAgency MCP by usefulapi

Read cases, contacts, tasks, notes and benefits; add cases, notes and tasks in NextAgency.

Should I use this

Quality & Safety

A
Description quality
86%
Schema completeness
93%
Naming quality
98%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (9)

  • LOWTool 'nextagency_list_case_custom_fields' description lacks action verbin nextagency_list_case_custom_fields
  • LOWTool 'nextagency_list_case_benefits' description lacks action verbin nextagency_list_case_benefits
  • LOWTool 'nextagency_list_case_tasks' description lacks action verbin nextagency_list_case_tasks
  • LOWTool 'nextagency_get_case_task' description lacks action verbin nextagency_get_case_task
  • LOWTool 'nextagency_get_case_note' description lacks action verbin nextagency_get_case_note
  • LOWTool 'nextagency_find_contacts_by_phone' description lacks action verbin nextagency_find_contacts_by_phone
  • LOWTool 'nextagency_list_sub_agents' description lacks action verbin nextagency_list_sub_agents
  • LOWTool 'nextagency_list_case_custom_fields' name length outside 3-30 rangein nextagency_list_case_custom_fields
  • LOWTool 'nextagency_find_contacts_by_phone' name length outside 3-30 rangein nextagency_find_contacts_by_phone

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,859Tokens (tool definitions)
~1.3 KBTypical response size
Significant attention impact (3.01% of 128k context)

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-http

What it can do

Tool inventory

Tools (22)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded22 tools