MCP

MCP works in both directions: your agents use tools from MCP servers you register, and MCP clients use MCPDial to place and read calls. See also the MCP overview.

Tools in: register a server

Dashboard → Tools → Add server. Give it a URL (streamable HTTP or SSE) and, if needed, an auth header — the secret is encrypted at rest. The dashboard connects, lists the server's tools and creates a default policy for each. Then allow tools per agent in the agent's Tools tab.

Per-tool policy

Field	Description
`enabled`boolean	Whether any agent may use the tool.
`mode`'read' \| 'write'	Writes are logged as actions on the call.
`confirm`boolean	Read the action back and wait for a spoken yes before calling it.
`latency`'instant' \| 'slow' \| 'offline'	instant runs inline; slow runs in the background while the agent talks; offline follows up after the call.
`timeout_ms`number	After this, the agent says it could not complete the action.

policy examplejson

{
  "crm.create_note":  { "enabled": true,  "mode": "write", "confirm": false, "latency": "slow",    "timeout_ms": 8000 },
  "orders.refund":    { "enabled": false, "mode": "write", "confirm": true,  "latency": "slow",    "timeout_ms": 8000 },
  "kb.search":        { "enabled": true,  "mode": "read",  "confirm": false, "latency": "instant", "timeout_ms": 1500 }
}

Tool results are screened for prompt injection before the model sees them.

Calls out: our MCP server

Create an API key in Settings → API keys and add the server to your MCP client:

mcp client configjson

{
  "mcpServers": {
    "phone": {
      "url": "https://<your-app>/api/v1/mcp",
      "headers": { "Authorization": "Bearer cv_live_…" }
    }
  }
}

Tool	Description
`list_agents`	The agents in the workspace, with role and status.
`create_agent`	Create an agent from a role template and your company details.
`place_call`	Place or schedule an outbound call with an agent — same gate as the REST API.
`get_call`	Status, transcript, outcome and actions of a call.
`list_calls`	Recent calls, filterable by agent and status.
`check_availability`	Free slots on a calendar.
`book_appointment`	Book a free slot on a calendar.