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.
The 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.
Claude reads Simp's discovery documents (see Authentication) and starts an OAuth 2.0 authorization code flow with PKCE (S256) and the resourceparameter set tohttps://voice.simpmobile.com/mcp.
Simp fetches the metadata document, checks it (the client_idmust equal the URL,token_endpoint_auth_methodnone, 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.
The 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.
| Scope | Tools |
|---|---|
tasks:write | create_task, cancel_task |
tasks:read | get_task, list_tasks |
input:respond | respond_to_decision |
account:read | get_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.
| Tool | Label | What it does |
|---|---|---|
get_task | read | One task's status, outcome and next step, with the card |
list_tasks | read | The user's recent tasks |
get_user_info | read | The user's simps, Simp numbers and saved contacts' names |
support_cases | read | The user's open and recent help requests |
cancel_task | write | Cancels a task, ending a live call |
support_ask | write | Sends the user's question to Simp support |
create_task | sensitive write | Sets up a real phone call |
respond_to_decision | sensitive write | Passes 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/listreturns only the four read tools:get_task,list_tasks,get_user_info,support_cases.- Every other tool,
support_askincluded, andtasks/updateandtasks/cancelanswerread_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:
| Code | Meaning | What to do |
|---|---|---|
read_only_access | The user chose read only | Say so; the user can reconnect with full access |
app_paused | Simp has paused Claude for now | The connection and settings are kept; try later |
app_daily_cap_reached | Today's limit for new tasks from Claude is reached | Try again after 00:00 UTC |
ai_apps_daily_cap_reached | Today's limit for new tasks from all AI apps is reached | Try again after 00:00 UTC |
ai_apps_cap_unavailable | Simp cannot check today's limit right now | Try 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.
