Able Platform MCPDocumentationContact support

Overview

Connect to Able MCP

Able MCP lets your AI assistant read the Able Platform data your account can already see: facilities, individuals and screening history. It is read-only and uses your existing permissions.

Server URLhttps://mcp.dev.able-care.dev/mcp

Step 1

Before you start

  • Your own Able Platform account with a verified email address. MCP access is limited to eligible work accounts; your administrator can confirm yours.
  • An AI client your organisation has approved for this data. The client's AI provider receives whatever your assistant reads from Able.
  • A client that supports remote MCP servers with OAuth sign-in. ChatGPT and Codex register themselves. Cursor and Claude need Able to register a callback first; each client's steps name the address to send.

Step 2

Add the server to your client

Choose the assistant you use. Every client uses the same server URL; only where you enter it differs.

ChatGPT

  1. 1In ChatGPT, open Settings, then Security and login, and turn on Developer mode.
  2. 2Go to Plugins, select the plus button and name the connection Able.
  3. 3Under Connection, paste the server URL below, create the connection and sign in to Able when prompted.
  4. 4In a new conversation, add Able from the tools menu.
Plugins › New connection
https://mcp.dev.able-care.dev/mcp

Developer mode depends on your account and workspace policy. If you cannot turn it on, ask your workspace admin. Menu names can change; see OpenAI's connection guide.

Codex

  1. 1Run the first command to add Able to Codex.
  2. 2If no browser window opens for sign-in, run the second command.
  3. 3Start a new Codex session so it loads Able's tools.
Terminal
codex mcp add able --url https://mcp.dev.able-care.dev/mcp
codex mcp login able --scopes mcp:read

Use the same name, able, in later commands. To switch accounts, run codex mcp logout able and sign in again.

Cursor Web

  1. 1Email support@able-care.co and ask Able to register https://www.cursor.com/agents/mcp/oauth/callback. We will reply with a client ID. Able uses a public client, so leave the client secret empty.
  2. 2Open cursor.com/agents, use the MCP dropdown and add a custom HTTP server named Able.
  3. 3Paste the configuration below. Replace CLIENT_ID with the ID Able sent you, then connect and approve read access.
cursor.com/agents
{
  "mcpServers": {
    "able": {
      "url": "https://mcp.dev.able-care.dev/mcp",
      "auth": {
        "CLIENT_ID": "CLIENT_ID",
        "scopes": ["mcp:read"]
      }
    }
  }
}

On a Team plan, an admin can share the server from Dashboard, then Plugins and MCPs. Each person still signs in with their own Able account. If the browser reports a different callback, send that exact address to support. See Cursor's cloud agent guide.

Cursor Agent

  1. 1Email support@able-care.co and ask Able to register http://localhost:8787/callback. We will reply with a client ID. Able uses a public client, so leave the client secret empty.
  2. 2Save the configuration below to ~/.cursor/mcp.json, or merge the able entry into the file you already have. Replace CLIENT_ID.
  3. 3Run agent mcp login able and approve read access in the browser.
  4. 4Start a new Agent session so it loads Able's tools.
~/.cursor/mcp.json
{
  "mcpServers": {
    "able": {
      "url": "https://mcp.dev.able-care.dev/mcp",
      "auth": {
        "CLIENT_ID": "CLIENT_ID",
        "scopes": ["mcp:read"]
      }
    }
  }
}

The Agent CLI uses the same configuration as the Cursor editor, and both send this callback. If you also use Cursor Web, ask Able to register both callbacks on the same client ID. Free port 8787 if another program is using it while you sign in. See Cursor's CLI guide.

Claude Web

  1. 1Email support@able-care.co and ask Able to register https://claude.ai/api/mcp/auth_callback. We will reply with a client ID. Able uses a public client, so leave the client secret empty.
  2. 2Open Customize, then Connectors, and choose Add custom connector. On a Team or Enterprise plan, an owner adds it under Organization settings, then Connectors, Add, Custom, Web.
  3. 3Name it Able, paste the server URL below, and choose Use your own OAuth client. Enter the client ID and leave the secret blank.
  4. 4Add the connector and choose Connect. In a chat, turn Able on from the plus menu.
Customize › Connectors
https://mcp.dev.able-care.dev/mcp

Use the client ID Able sends you. Automatic registration is turned off for this server. Menu names can change; see Claude's connector guide.

Claude Code

  1. 1Email support@able-care.co and ask Able to register http://localhost:8080/callback. We will reply with a client ID. Able uses a public client, so leave the client secret empty.
  2. 2Run the first command to add Able. Replace CLIENT_ID with the ID Able sent you.
  3. 3Run the second command and approve read access in the browser.
  4. 4Start a new Claude Code session so it loads Able's tools.
Terminal
claude mcp add --transport http --client-id CLIENT_ID --callback-port 8080 able https://mcp.dev.able-care.dev/mcp
claude mcp login able

Able matches http://localhost:8080/callback exactly, including the port. If 8080 is busy, choose a free port, ask Able to register that port's callback, and pass the same port to --callback-port. See Claude Code's MCP guide.

Other clients

  1. 1Check that your client supports remote MCP servers with OAuth sign-in and lets you enter a client ID.
  2. 2Email support@able-care.co with the client's name and its exact OAuth callback URLs. We will register it and send you a client ID.
  3. 3Add the server URL below and your client ID in the client's MCP settings, then sign in.
Server URL
https://mcp.dev.able-care.dev/mcp

Use this path for a client that is not listed above.

Step 4

Check the connection

Start a new conversation and ask your assistant to use Able. Confirm the account and organisation before you ask about individuals; Able's get_my_context tool answers that. For example:

  • Which Able account and organisation am I connected to?
  • List the facilities I can access.
  • Which of my facilities have the most individuals at risk?

Help

Troubleshooting

My client keeps asking me to sign in

Your connection has expired or been revoked. Reconnect Able in your client's connection settings and finish the browser sign-in. In Codex, run codex mcp login able. In Cursor Agent, run agent mcp login able. In Claude Code, run claude mcp login able. You do not need to restart anything.

The email code does not work

Codes expire. Request a new code on the Able sign-in page and use the most recent email. Never type the code into a chat.

I signed in but see no data

Able MCP uses your existing permissions. If you cannot see a record in the Able portal, your assistant cannot see it either. If Able asks you to verify your email, do that in the portal first. For anything else, ask your Able administrator to check your account and facility access; signing in again does not add permissions.

Setup asks for a client ID or shows invalid_client

ChatGPT and Codex register automatically. For Cursor or Claude, follow that client's steps and use the client ID Able sent you. For any other client, follow Other clients. Do not invent a client ID or turn authentication off.

My assistant does not use Able

Turn Able on for the conversation and ask your assistant to use it. After an Able update, refresh the connection so your client sees the latest tools.

How do I disconnect Able?

Remove Able from your client, or sign out there. In Codex, run codex mcp logout able. In Claude Code, run claude mcp logout able. Signing out of the Able portal does not disconnect your AI client.

Still stuck? Email support@able-care.co with your client, the time and any error code. Never include sign-in codes, tokens or patient data.