ErzyCall API
    ErzyCall API

    Getting Started

    Quick StartAuthentication

    Guides

    Rate LimitingError HandlingWebhooks

    MCP

    OverviewChat assistantsCoding toolsAutomation platformsTools & permissionsTroubleshooting

    API Reference

    CallsContactsCasesAssistantsPhone NumbersContact GroupsUsageWebhook EndpointsWhatsApp

    Overview

    Connect ErzyCall to ChatGPT, Claude, or your automation platform over MCP.

    ErzyCall publishes an MCP server. MCP (Model Context Protocol) is an open standard that lets an AI assistant use an outside service — a universal adapter between your AI and your tools.

    Once connected you can type "call Maria and confirm tomorrow's 3pm appointment" or "how did yesterday's calls go?" and the assistant does it in your ErzyCall account, using your phone numbers, contacts, and call scripts.

    Connection details

    FieldValue
    Server / Endpoint URLhttps://app.erzycall.com/api/mcp
    TransportStreamable HTTP (SSE is not supported)
    AuthenticationOAuth 2.1 with PKCE & Dynamic Client Registration
    Client ID / SecretLeave blank — the server registers your tool automatically
    HeadersLeave empty. An Authorization header will break OAuth in most tools.
    Suggested nameErzyCall
    Suggested descriptionTrigger and manage ErzyCall AI phone calls, contacts, and WhatsApp

    You do not need an ErzyCall API key for MCP. API keys are only for the REST API, used by platforms that can't speak MCP.

    What you get

    • You stay in control — the assistant asks for confirmation before it places a real call or sends a message.
    • Scoped to one organization — during sign-in you pick which ErzyCall organization to connect. Only that org's data is reachable.
    • Revocable anytime — remove the connector in your AI tool to disconnect it. Tokens also expire, and a password change or organization change ends the grant.

    Before you begin

    • An ErzyCall account you can sign into in a browser, with at least one organization.
    • At least one phone number assigned to that organization (otherwise calls have nothing to dial from).
    • Admin rights in your AI tool if you're on a Team / Business / Enterprise plan — in most, only an owner or admin can add a custom connector.

    Set up your tool

    • Chat assistants — ChatGPT, Claude
    • Coding tools — Claude Code, Cursor, Hermes, VS Code, Windsurf/Devin, Zed
    • Automation platforms — n8n, Make.com, Zapier
    • Tools & permissions — what the assistant can do once connected
    • Troubleshooting

    If your tool isn't listed, look for a setting called Custom connector, MCP server, Remote MCP, or Add server, and paste the values from the table above.

    Technical details (for IT / security review)

    • Protected-resource metadata: https://app.erzycall.com/api/mcp/.well-known/oauth-protected-resource
    • Authorization server metadata: https://app.erzycall.com/api/mcp/.well-known/oauth-authorization-server
    • Authorization endpoint: https://app.erzycall.com/oauth/authorize
    • Token endpoint: https://app.erzycall.com/oauth/token
    • Dynamic client registration (RFC 7591): https://app.erzycall.com/api/mcp/oauth/register
    • Grant types: authorization_code, refresh_token · PKCE: S256 (required)
    • Bearer token in the Authorization header. GET on the endpoint returns 405 — POST-only Streamable HTTP.
    • Scopes: calls:read calls:write contacts:read contacts:write contact_groups:read cases:read cases:write assistants:read assistants:write phone_numbers:read whatsapp:read whatsapp:write usage:read

    Webhooks

    Receive real-time event notifications via webhooks.

    Chat assistants

    Connect ErzyCall to ChatGPT and Claude. No technical skill needed.

    On this page

    Connection detailsWhat you getBefore you beginSet up your toolTechnical details (for IT / security review)