DialMCP MCP server

DialMCP Connector

Give your AI agent a phone. Open-source connector for DialMCP — the hosted MCP server that lets AI agents place real phone calls from your own verified number.

What this is

DialMCP is a remote MCP server at https://mcp.dialmcp.com/mcp. Any client that speaks Streamable HTTP with OAuth can connect to it directly — no install, no API keys. You do not need this package for those clients.

This repository exists for two reasons:

remote servers. dialmcp-connector launches a local stdio server that proxies to the hosted endpoint and handles the OAuth browser flow for you.

1. A stdio bridge for clients that only support local servers. Some MCP clients still can't talk to

server.json registry manifest, and the safety model — in one auditable place.

1. The open, canonical documentation of the DialMCP integration — tool schemas, client configs, the

The hosted calling service itself is closed-source. This connector is MIT-licensed and contains no proprietary logic: it is a thin transport shim over a public endpoint.

Quick start

Direct connection (preferred)

If your client supports remote MCP servers, skip this package entirely:

URL:        https://mcp.dialmcp.com/mcp
Transport:  Streamable HTTP
Auth:       OAuth 2.1 (sign in with your phone number)

Claude Code

claude mcp add --transport http dialmcp https://mcp.dialmcp.com/mcp
# add --scope user to enable it in every project

Codex — ~/.codex/config.toml

[mcp_servers.dialmcp]
url = "https://mcp.dialmcp.com/mcp"

claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → paste https://mcp.dialmcp.com/mcp.

Gamut

Settings → Connectors → Add MCP server → paste the URL (HTTP / OAuth) → complete SMS verification.

On first connect a browser window opens for sign-in. Verify your phone number with an SMS code — that number becomes your caller ID.

Via this connector (stdio-only clients)

npx dialmcp-connector

Or in an MCP client config:

{
  "mcpServers": {
    "dialmcp": {
      "command": "npx",
      "args": ["-y", "dialmcp-connector"]
    }
  }
}

See examples/ for ready-to-paste configs.

Tools

The API is async by design: placecall returns instantly with a call ID and your agent polls getcall, so a multi-minute call never trips a client's tool timeout.

Shortened. The full README is on GitHub.