API · MCPLive
Drive your business phone from code, or from Claude.
A REST API for your integrations, and an MCP server so your AI assistant can read your calls, messages and contacts. Open on every plan, free included.
MCP server
Give Claude access to your business phone
Remote server, Streamable HTTP transport: nothing to install on the Relay side. Your API key is the authentication, and revoking it cuts access instantly. Sixteen tools, which follow your plan's features.
Server URL
https://api.yesrelay.com/api/mcp
Claude Code
claude mcp add --transport http relay https://api.yesrelay.com/api/mcp \ --header "Authorization: Bearer rk_live_..."
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"relay": {
"command": "npx",
"args": ["mcp-remote", "https://api.yesrelay.com/api/mcp",
"--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer rk_live_..." }
}
}
}Calls and messages
- relay_list_numbers
- relay_list_calls
- relay_get_transcript
- relay_list_messages
- relay_send_sms
Contacts and team
- relay_search_contacts
- relay_create_contact
- relay_update_contact
- relay_list_members
Flow (Business and Scale)
- relay_list_flows
- relay_get_flow
- relay_flow_schema
- relay_create_flow
- relay_save_flow_draft
- relay_check_flow
- relay_discard_flow_draft
REST API
Your calls, texts and contacts as JSON
Bearer key authentication. 30 requests per minute on the free plan, 120 on paid plans. Errors follow the problem+json format. A send refused by a safeguard says so clearly: recipient_opted_out, daily_limit_reached, workspace_budget_reached or sending_suspended.
First request
curl https://api.yesrelay.com/api/v1/me \ -H "Authorization: Bearer rk_live_..."
GET /api/v1/meYour organization and planGET /api/v1/workspacesTeams and their numbersGET /api/v1/workspaces/{id}/callsCall historyGET /api/v1/workspaces/{id}/calls/{call_id}/transcriptA call's transcriptGET /api/v1/workspaces/{id}/messagesSMS historyPOST /api/v1/workspaces/{id}/messagesSend a textGET /api/v1/workspaces/{id}/contactsList or search contactsEvery route, its parameters and responses: the OpenAPI reference. For real-time events, see the webhooks and integrations.