ErzyCall API
    ErzyCall API

    Getting Started

    Quick StartAuthentication

    Guides

    Rate LimitingError HandlingWebhooks

    MCP

    OverviewChat assistantsCoding toolsAutomation platformsTools & permissionsTroubleshooting

    API Reference

    CallsContactsCasesAssistantsPhone NumbersContact GroupsUsageWebhook EndpointsWhatsApp

    Coding tools

    Add ErzyCall to Claude Code, Cursor, Hermes, VS Code, Windsurf/Devin, and Zed.

    Every config file uses a different key name — mcpServers, servers, context_servers, mcp_servers — and some need url while others need serverUrl or an extra type. Copying a working snippet from one tool into another is the most common failure. Use the block from the matching section.

    Claude Code (terminal)

    1. Add the server:

      claude mcp add --transport http erzycall https://app.erzycall.com/api/mcp

      Add --scope user to make it available in every project, or --scope project to write a shared .mcp.json your team can commit.

    2. Sign in. Inside a Claude Code session type /mcp and pick ErzyCall — your browser opens for the OAuth flow. From a plain shell:

      claude mcp login erzycall
    3. Confirm it worked:

      claude mcp list

      You want ✔ Connected next to erzycall.

    Headless / SSH. On a machine with no browser, use claude mcp login erzycall --no-browser and open the printed URL elsewhere. Non-interactive runs (claude -p, the Agent SDK) cannot perform OAuth — authenticate once from an interactive session first.

    Cursor

    Option A — the one-click link

    If Cursor is installed, this link adds ErzyCall for you:

    cursor://anysphere.cursor-deeplink/mcp/install?name=erzycall&config=eyJ1cmwiOiJodHRwczovL2FwcC5lcnp5Y2FsbC5jb20vYXBpL21jcCJ9

    Option B — edit the config file

    1. Create or open ~/.cursor/mcp.json (every project) or .cursor/mcp.json in your project folder (that project only).

    2. Paste this. If the file already has other servers, add just the "erzycall" block inside the existing mcpServers.

      ~/.cursor/mcp.json
      {
        "mcpServers": {
          "erzycall": {
            "url": "https://app.erzycall.com/api/mcp"
          }
        }
      }
    3. Open the Customize page in Cursor's sidebar, find erzycall under MCP, and complete the sign-in prompt.

    Why there's no type field. Cursor treats any entry with a url as a remote server automatically. Adding "type": "http" is a common copy-paste mistake and can cause the entry to be ignored.

    Hermes

    Hermes Agent (Nous Research) uses YAML, not JSON. Indentation matters — two spaces, never tabs.

    Option A — the CLI

    hermes mcp add erzycall --url https://app.erzycall.com/api/mcp --auth oauth
    hermes mcp login erzycall

    Option B — edit the config file

    1. Open ~/.hermes/config.yaml.

    2. Add (or extend) the mcp_servers section:

      ~/.hermes/config.yaml
      mcp_servers:
        erzycall:
          url: "https://app.erzycall.com/api/mcp"
          auth: oauth
    3. From a fresh terminal window, run hermes mcp login erzycall and complete the browser sign-in.

    4. Verify with hermes mcp test erzycall.

    If you edit config.yaml while a Hermes session is open, it auto-reloads with a 30-second timeout — not enough to finish an OAuth sign-in, so it will appear to fail. Always run hermes mcp login from a separate, fresh terminal, which gives you a 5-minute window.

    Tools appear to the model as mcp_erzycall_<tool>, e.g. mcp_erzycall_create_call. Tokens are cached at ~/.hermes/mcp-tokens/erzycall.json.

    VS Code (Copilot agent mode)

    Guided way

    1. Press Ctrl/Cmd + Shift + P and run MCP: Add Server.
    2. Choose HTTP, paste https://app.erzycall.com/api/mcp, name it erzycall.
    3. Pick Workspace (this project) or Global (everywhere). VS Code opens a browser for sign-in on first use.

    Manual way

    .vscode/mcp.json
    {
      "servers": {
        "erzycall": {
          "type": "http",
          "url": "https://app.erzycall.com/api/mcp"
        }
      }
    }

    Unlike Cursor, VS Code requires the type field, and the top-level key is servers, not mcpServers.

    One-liner from a terminal:

    code --add-mcp "{\"name\":\"erzycall\",\"type\":\"http\",\"url\":\"https://app.erzycall.com/api/mcp\"}"

    If you use Agent Host. It doesn't read .vscode/mcp.json directly. For config that works across every Copilot surface, put the same servers block in .mcp.json at your workspace root, or in ~/.copilot/mcp-config.json.

    Windsurf / Devin Desktop

    Windsurf is now Devin Desktop (Cognition), and it has two agents that read different config files. Putting the config in the wrong file is the number one reason it "doesn't show up."

    Devin Local agent (default for new tabs)

    devin mcp add erzycall https://app.erzycall.com/api/mcp
    devin mcp login erzycall

    Or edit .devin/mcp_config.local.json (this project, private), .devin/mcp_config.json (project, shared), or ~/.config/devin/mcp_config.json — on Windows, %APPDATA%\devin\mcp_config.json:

    ~/.config/devin/mcp_config.json
    {
      "mcpServers": {
        "erzycall": {
          "url": "https://app.erzycall.com/api/mcp",
          "transport": "http"
        }
      }
    }

    Legacy Cascade agent

    Note the key is serverUrl, not url:

    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "erzycall": {
          "serverUrl": "https://app.erzycall.com/api/mcp"
        }
      }
    }

    Zed

    Guided way

    1. Settings → AI → MCP Servers.
    2. Click Add Server, then Add Remote Server.
    3. Name it erzycall, paste https://app.erzycall.com/api/mcp, and leave the header field empty.
    4. Zed prompts you to sign in. The indicator dot turns green when it's live.

    Manual way

    Zed settings.json
    {
      "context_servers": {
        "erzycall": {
          "url": "https://app.erzycall.com/api/mcp"
        }
      }
    }

    Don't add a header. Zed only offers the OAuth sign-in when there is no Authorization header configured. If you add one, Zed assumes you're handling auth yourself and the sign-in prompt never appears.

    Chat assistants

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

    Automation platforms

    Connect ErzyCall to n8n, Make.com, and Zapier.

    On this page

    Claude Code (terminal)CursorOption A — the one-click linkOption B — edit the config fileHermesOption A — the CLIOption B — edit the config fileVS Code (Copilot agent mode)Guided wayManual wayWindsurf / Devin DesktopDevin Local agent (default for new tabs)Legacy Cascade agentZedGuided wayManual way