agenttext-mcp

MCP server for AgentText — text messaging inboxes for AI agents.

Give your AI agents real phone numbers. Send and receive SMS, parse OTPs, thread conversations — all through the Model Context Protocol.

Quick Setup

1. Get an API key

curl -X POST https://agenttext-api-production.up.railway.app/v0/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "My Company", "email": "[email protected]"}'

Or sign up at agenttext.dev.

2. Add to your MCP config

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "agenttext": {
      "command": "npx",
      "args": ["-y", "agenttext-mcp"],
      "env": {
        "AGENTTEXT_API_KEY": "atx_live_..."
      }
    }
  }
}

Cursor (.cursor/mcp.json in your project, or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "agenttext": {
      "command": "npx",
      "args": ["-y", "agenttext-mcp"],
      "env": {
        "AGENTTEXT_API_KEY": "atx_live_..."
      }
    }
  }
}

Claude Code (~/.claude.json or project .mcp.json):

{
  "mcpServers": {
    "agenttext": {
      "command": "npx",
      "args": ["-y", "agenttext-mcp"],
      "env": {
        "AGENTTEXT_API_KEY": "atx_live_..."
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | create_inbox | Provision a new phone number | | list_inboxes | List all your phone number inboxes | | send_message | Send an SMS from an inbox | | list_messages | List messages with optional filters | | wait_for_message | Long-poll for inbound SMS (OTP flows) |

Usage Examples

Once configured, you can ask your AI agent:

"Create a new phone number inbox called 'OTP Verifier'"

"Send a text to +15551234567 saying 'Please verify my account'"

"Wait for an OTP code on my inbox"

"Show me all inbound messages from today"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AGENTTEXT_API_KEY | Yes | Your AgentText API key (atx_live_...) | | AGENTTEXT_API_URL | No | Custom API base URL (default: production) |

Pricing

• Free: $5 credit, 1 inbox, ~100 texts
• Builder: $29/mo, 5 inboxes, 2,000 texts
• Scale: $149/mo, 25 inboxes, 15,000 texts

Links

• AgentText — Homepage
• API Reference — Full REST API docs
• GitHub — Source code

License

MIT