NextAgency MCP server

Read cases, contacts, tasks, notes and benefits; add cases, notes and tasks in NextAgency. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.

Connect NextAgency50 free tool calls a month

What can I ask?

Turn on the NextAgency connector, then ask in plain words. The AI picks the tools.

What you can do with NextAgency in Claude and ChatGPT

For insurance brokers and agency staff who manage cases, contacts and tasks in NextAgency.

Review cases by sales status

List the cases with a sales status, such as Prospect or Client, one page at a time. Open one case to read its stage, owner and addresses.

Find a contact by name, email or phone number

Search the contacts by name or email, or find the contacts that use a phone number. Open one contact to read its emails, phone numbers and addresses.

Check the tasks and notes of a case

List the tasks of a case with their stage, due date and assignees. Read the notes of the case, including the full text of one note.

Review the employees and benefits of a case

List the employees and insurance benefits of one case, with pay cycles and policy types. Social security numbers are removed from the record fields.

Open a case with a note and a task

Create a case with a name, then add a note with the context. Add a task for a user, using the user id from the user list.

Changes data

How do I connect NextAgency?

Before you connect

You need your own NextAgency API app. The login page asks for its Client ID and Client secret; then you sign in with your NextAgency account and approve the access (OAuth).

Your agency administrator enables the API under Settings > Integrations > API and copies the Client ID and Secret ID there. Add the redirect URL https://nextagency.usefulapi.io/callback to the application. Enter the Client ID and Secret ID on the next page. The secret is stored encrypted and is used only to sign you in and refresh your NextAgency access.

Your NextAgency address is the part before .nextbroker.io, for example youragency. The API is an add-on: an administrator of your agency must enable it. This server reads cases, contacts, tasks, notes, benefits, employees and users, and it can create cases, case notes and case tasks. It never deletes anything. Social security numbers, tax ids and Medicare ids are removed from the record fields, and SSNs in note text are masked. It can see only what your NextAgency user can see. You can revoke access any time in NextAgency.

Claude claude.ai · Desktop

  1. Open Customize → Connectors, then click + Add → Add custom connector.
  2. Enter the name NextAgency and this URL, then click Add:
    https://nextagency.usefulapi.io/mcp
  3. Claude opens the login page: enter your own NextAgency app's client ID and secret, then sign in and approve the access.
  4. In a chat, click + → Connectors and turn on NextAgency.

Team and Enterprise: an Owner adds the connector for the organization first.

ChatGPT chatgpt.com

  1. Open Plugins, click +, then Add custom MCP server.
  2. Enter the name NextAgency and this URL, choose OAuth as the authentication, confirm the warning and create it:
    https://nextagency.usefulapi.io/mcp
  3. ChatGPT opens the login page: enter your own NextAgency app's client ID and secret, then sign in and approve the access.
  4. In Plugins, install NextAgency, then choose it in a chat.

No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.

Claude Code

Run this command, then run /mcp in Claude Code to log in:

claude mcp add --transport http nextagency https://nextagency.usefulapi.io/mcp

Cursor

Add to Cursor or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "nextagency": {
      "url": "https://nextagency.usefulapi.io/mcp"
    }
  }
}

VS Code

Add to VS Code or add this to .vscode/mcp.json:

{
  "servers": {
    "nextagency": {
      "type": "http",
      "url": "https://nextagency.usefulapi.io/mcp"
    }
  }
}

Codex

Run these commands. The second one opens the login page:

codex mcp add nextagency --url https://nextagency.usefulapi.io/mcp
codex mcp login nextagency

Other clients

Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.

https://nextagency.usefulapi.io/mcp

Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: you enter your own NextAgency app's client ID and secret, then sign in with your NextAgency account. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Proper user$9/mo · $90/yr10,000 tool calls / month
Pro+per user$39/mo · $390/yr100,000 tool calls / month

Each paid plan covers this NextAgency server only. Ask your AI to run nextagency_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with nextagency_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with nextagency_upgrade before then undoes the cancel. Or write to [email protected].

Tools 26

Show all 26 tools (the AI picks them for you)

Read only · 19

  • Get my profilenextagency_get_profile
    The NextAgency user the token acts as: id, name, email and role. Use it to check the connection.
  • List usersnextagency_list_users
    The agency's users (brokers and staff): id, name, email, role. Use the id as assigned_to in nextagency_create_case_task.
  • List casesnextagency_list_cases
    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.
  • Search casesnextagency_search_cases
    Cases whose name, number or contact details match the query, one page at a time.
  • Get a casenextagency_get_case
    One case by id: its details, status, stage, owner and addresses.
  • List a case's contactsnextagency_list_case_contacts
    The contacts linked to one case, with the primary flag. Use nextagency_get_contact for one contact.
  • List a case's employeesnextagency_list_case_employees
    The employees of one case (group business): name, employment type, start and termination dates, pay cycle.
  • List a case's custom fieldsnextagency_list_case_custom_fields
    The custom fields of one case, with their names and values.
  • List a case's benefitsnextagency_list_case_benefits
    The insurance benefits (policies) of one case: type, carrier and features.
  • List a case's tasksnextagency_list_case_tasks
    The tasks of one case: title, stage, type, priority, due date and assignees.
  • Get a case tasknextagency_get_case_task
    One task of a case by id.
  • List a case's notesnextagency_list_case_notes
    The notes of one case: title, body, pinned flag, author and assignees. Use nextagency_get_case_note for one note.
  • Get a case notenextagency_get_case_note
    One note of a case by id, with its full body.
  • List contactsnextagency_list_contacts
    The agency's contacts, one page at a time: name, emails, phone numbers and addresses.
  • Search contactsnextagency_search_contacts
    Contacts whose name, email or details match the query, one page at a time.
  • Find contacts by phone numbernextagency_find_contacts_by_phone
    The contacts that have this phone number. Enter the digits only, for example 5551234567.
  • Get a contactnextagency_get_contact
    One contact by id: name, emails, phone numbers and addresses.
  • List carriersnextagency_list_carriers
    The insurance carriers in the agency's list: name, states and contact details.
  • List sub-agentsnextagency_list_sub_agents
    The sub-agents (vendors and individual agents) of the agency.

Changes data · 3

  • Create a casenextagency_create_case
    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.
  • Add a case notenextagency_create_case_note
    WRITE: add a note to one case. Use the title for a short label and the body for the text. Returns the new note.
  • Add a case tasknextagency_create_case_task
    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.

Your usefulapi plan · 4

  • Usage status (free-tier meter)nextagency_usage_status
    Report the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter.
  • Request a missing featurenextagency_request_feature
    Tell usefulapi that the user needs something the NextAgency tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter.
  • Upgrade to Pro or Pro+nextagency_upgrade
    Get a paid plan for NextAgency (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter.
  • Cancel the Pro subscriptionnextagency_cancel_subscription
    Cancel the caller's NextAgency Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run nextagency_upgrade later to undo the cancel before the period ends. Does not count against the meter.

FAQ

What can I do with NextAgency in Claude or ChatGPT?

Review cases by sales status. Find a contact by name, email or phone number. Check the tasks and notes of a case. Review the employees and benefits of a case. Open a case with a note and a task. See what you can do for the details.

Is this an official NextAgency product?

No. usefulapi is an independent service. It is not affiliated with or endorsed by NextAgency. The server calls the NextAgency API with your own NextAgency access, so it sees only the data that your account can see.

Can I connect NextAgency to Claude or ChatGPT?

Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.

What do I need to connect?

A NextAgency account with API access and your own NextAgency API app (its client ID and secret). See Before you connect for how to create it.

Do I add an Authorization header to the client config?

No. Add only the URL. Do not add an Authorization header or an API key to the client config. The server signs you in with OAuth: you enter your own NextAgency app's client ID and secret, then sign in with your NextAgency account. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

How do you keep my NextAgency credentials?

The login stores them encrypted in the authorization grant of your connection. The server uses them to call the NextAgency API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. You can revoke the access in NextAgency at any time.

Can the AI change my NextAgency data?

Yes, if you approve it. 3 of the 22 NextAgency tools can create or change data. The other 19 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.

What does it cost?

The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this NextAgency server only. Cancel any time: your paid plan then runs to the end of the paid period. Run nextagency_usage_status to see how many calls you used.

How do I subscribe or cancel?

Ask the AI to run nextagency_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run nextagency_cancel_subscription. Your paid plan continues to the end of the paid period.

What if a NextAgency tool that I need is missing?

Tell the AI what you wanted to do. It can send the request with nextagency_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.

Which AI clients can I use?

Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.

Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.

More CRM & Sales MCP servers

AgencyBlocAgencyZoomBuilder PrimeCentralStationCRMChurchSuiteCiviCRMClimatoolsCogmentoCopperEnerfloFolkFollow Up BossFreshsalesGetfly CRMGlue UpInsightlyIRIS CRMJobNimbuskeyCRMKommoLess Annoying CRMMethod CRMmyPhonernoCRM.ioPerfectViewPestScanPipedrivePipeline CRMPobuca ConnectPropstackQuotaPathRevamp CRMRex SoftwareSalesDriveSalesRabbitSellsyServiceMinderServiceMonsterSolarPlusSuiteDashTeamgateTeamleader FocusTwentyVtigerwebCRMWobakaZomentum

All CRM & Sales servers →