Simp Connect in Claude

How Claude connects to Simp Connect: sign-in with Claude's Client ID Metadata Document, scopes, the eight tools with their read and write labels, the status card, the approval flow, read-only access, errors, rate limits, AI disclosure and where Simp is available.

Claude reaches Simp as a remote MCP connector at https://voice.simpmobile.com/mcp, on claude.ai and in the Claude apps. Simp treats it as a first-class AI app: it is named Claude everywhere a user sees it, it gets the standard rate limits, and it shows Simp's status card in the conversation. The step-by-step menus are in Connect guides.

Connecting#

Claude registers itself with a Client ID Metadata Document (CIMD): its client_id is an https URL, and the JSON served there is its registration. There is no client secret and nothing to register with Simp. Claude's document is https://claude.ai/oauth/mcp-oauth-client-metadata; Claude Code has its own.

  1. Step 1The user adds Simp as a connector with the MCP URL above. Under OAuth client, Use Claude's published identity is the metadata document; Simp does not offer dynamic client registration.
  2. Step 2Claude reads Simp's discovery documents (see Authentication) and starts an OAuth 2.0 authorization code flow with PKCE (S256) and the resource parameter set to https://voice.simpmobile.com/mcp.
  3. Step 3Simp fetches the metadata document, checks it (the client_id must equal the URL, token_endpoint_auth_method none, https redirect URIs) and shows Simp's sign-in, headed "Connect Claude to your Simp": Open Simp on a phone, a QR code on a computer.
  4. Step 4The user approves in the Simp app, where the request reads "Claude wants to connect to your Simp" and lists what Claude is asking for. Claude exchanges the code at the token endpoint as a public client.

Then try: "Ask Simp to call Bella Napoli and book a table for two on Friday at 7."

Scopes#

Claude asks for all four scopes, and the eight tools need no other: tasks:write, tasks:read, input:respond, account:read.

ScopeTools
tasks:writecreate_task, cancel_task
tasks:readget_task, list_tasks
input:respondrespond_to_decision
account:readget_user_info, support_ask, support_cases

Access tokens last 60 minutes; refresh tokens last 30 days and rotate on every use.

Tools and their labels#

Every tool carries a title, the MCP hints (readOnlyHint on the read tools, destructiveHint on the tools that change something or reach someone) and Simp's label in _meta["simp/access"]. In Claude, a read-only tool can run without asking each time and a tool marked destructive always asks the user first (Anthropic's connector review criteria, read 2026-11-13). The tool reference carries all of them.

ToolLabelWhat it does
get_taskreadOne task's status, outcome and next step, with the card
list_tasksreadThe user's recent tasks
get_user_inforeadThe user's simps, Simp numbers and saved contacts' names
support_casesreadThe user's open and recent help requests
cancel_taskwriteCancels a task, ending a live call
support_askwriteSends the user's question to Simp support
create_tasksensitive writeSets up a real phone call
respond_to_decisionsensitive writePasses the user's answer into a live call

Full arguments, examples and schemas are on Tools.

The status card#

create_task and get_task return Simp's status card as an MCP Apps resource, and Claude shows it in the conversation: the task, the simp, who is being called and how far it has got, and, once the call ends, the outcome and a short summary. The card follows the task live, has one Open Simp button and never an approve button: approval stays in the Simp app. Details: Status card.

The default simp and number#

Every task uses the user's default simp and default Simp number unless the user names another. When the user names a simp, or one of their own numbers ("from my US number"), Claude passes persona or from_number exactly as get_user_info lists them.

The approval flow#

A new connection asks every time: create_task answers status: "awaiting_approval" and the user approves or declines the call in the Simp app. An approval stays open for one hour from the request, scheduled or not; after that the task closes and nobody is contacted (Approval: one hour). The user can give the connection lighter rules in the Simp app; see Permissions.

If the simp needs the user during a call, get_task lists the question in pending_decisions, and respond_to_decision passes the user's answer to the call. The first answer wins, whether it comes from Claude or the Simp app.

Read-only access#

A connection can be Read only, a setting on the connection rather than a scope. The approval in the Simp app does not offer that choice today, so a connection made there has full access. A read-only connection:

  • tools/list returns only the four read tools: get_task, list_tasks, get_user_info, support_cases.
  • Every other tool, support_ask included, and tasks/update and tasks/cancel answer read_only_access. The user can disconnect Simp in the Simp app (Profile, then AI apps, then the app, then Disconnect) and connect it again with full access.

Errors#

Every error carries a code and a sentence that says what happened and what to do; errors any tool can return are on Errors. The ones a Claude conversation can meet:

CodeMeaningWhat to do
read_only_accessThe user chose read onlySay so; the user can reconnect with full access
app_pausedSimp has paused Claude for nowThe connection and settings are kept; try later
app_daily_cap_reachedToday's limit for new tasks from Claude is reachedTry again after 00:00 UTC
ai_apps_daily_cap_reachedToday's limit for new tasks from all AI apps is reachedTry again after 00:00 UTC
ai_apps_cap_unavailableSimp cannot check today's limit right nowTry again in a few minutes

A missing or expired token is an HTTP 401 with a WWW-Authenticate challenge, which Claude answers by asking the user to sign in again; a token without a tool's scope is a 403 naming the scope.

Rate limits#

Claude is on the standard tier: 600 tool calls and 200 new tasks a minute across all Claude users, and 60 tool calls and 20 new tasks a minute for each user. A hit is a rate_limited tool error carrying retry_after_seconds. Each connection also has its own daily task cap, 50 on the default mode, and Simp caps new tasks per AI app and across all AI apps each day. Details: Rate limits and Daily caps.

AI disclosure#

The simp always says it is an AI when asked, on every call. Simp follows the rules of each country it operates in.

Where Simp is available#

Simp accounts and Simp numbers are available in the UK, the US and Canada, and every call is placed from the user's own Simp number.