Documentation

Connect your AI

Everything here happens once. Grab your key from the portal, paste it where your assistant keeps its connectors, and start texting.

1. Get your key and number

Create an account, create your phone number under Numbers, then create an API key under Connect. Keys look like tmcp_live_… and are shown once.

2a. MCP-capable assistants

Claude Desktop, Cursor, ChatGPT connectors and anything else that speaks MCP over HTTP. Add this server:

{
  "mcpServers": {
    "textmcp": {
      "url": "https://textmcp.com/api/public/mcp",
      "headers": { "Authorization": "Bearer tmcp_live_..." }
    }
  }
}

Your assistant will see four tools: send_text, list_messages, list_numbers and check_balance.

2b. Everything else (REST)

Any tool that can make an HTTP request can text. Send:

curl -X POST https://textmcp.com/api/public/v1/messages \
  -H "Authorization: Bearer tmcp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "+15551234567", "message": "Running late!"}'

Read history:

curl "https://textmcp.com/api/public/v1/messages?limit=20&search=invoice" \
  -H "Authorization: Bearer tmcp_live_..."

3. Receiving replies

Replies land on your number automatically and appear in History and in list_messages. Each received text costs one credit, same as a sent one.

Good to know

· Phone numbers must be E.164 format: +1 followed by the 10 digits.
· Out of credits returns HTTP 402 — top up and retry.
· Revoking a key takes effect immediately; create a new one anytime.
· Rotating a number releases the old one and issues a fresh one for $5.

Create an account See pricing