MCP pages

Safety model

The MCP only reads. What no key can do, or should not do over MCP, is left out and listed below with the reason. So your client has no risky actions to approve.

What each key does over MCP

  • «Read only»: reads agents, calls, campaigns, numbers, tools, the knowledge base and widgets. It is enough for MCP.
  • «Read and calls»: reads the same and, through the API, also asks for and cancels outbound calls. Over MCP it does the same as «Read only»: the MCP makes no calls.

What is left out

In short, over MCP your assistant cannot: create, change or delete agents, tools, widgets or the knowledge base; make, end, cancel or retry calls; buy, assign or delete numbers; read the organization's secrets. All of this is done in the console.

See the technical list (45 actions)

GET /ready

Readiness lists the state of Atendia's internal services. The public gateway never publishes it (deploy/*/Caddyfile); the MCP must not either.

POST /agents

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /agents/:agentId/preview-session

A test conversation with an agent spends credit or free test minutes. An API key must never open one; test the agent in the console.

PATCH /agents/:id

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /agents/:agentId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /agents/:agentId/config

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /calls/live/end

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /calls/:callId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /kb

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

GET /kb/upload-url

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

PATCH /kb/:kbId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /kb/:kbId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

GET /numbers/search

The number search belongs to associating a number, which only the console does. No organization API key may search: the Atendia API answers 403 to both key types.

POST /numbers

Session-only money-moving operation. Organization API keys and MCP callers cannot purchase phone numbers.

PATCH /numbers/:phId

Owner/admin session-only number management is not exposed to API-key MCP callers.

DELETE /numbers/:phId

Session-only destructive billing operation. API-key MCP callers cannot release phone numbers.

POST /outbound-calls

Places a real call, at a cost. Outbound calls are not available over MCP.

POST /outbound-calls/quick

Places a real call, at a cost. Outbound calls are not available over MCP.

GET /outbound-calls/batch-upload-url

Only used to upload a campaign list. Campaigns are not available over MCP.

POST /outbound-calls/batches

Starts a campaign of real calls, at a cost. Campaigns are not available over MCP.

POST /outbound-calls/batches/list

Starts a campaign of real calls, at a cost. Campaigns are not available over MCP.

GET /outbound-calls/batches/:campaignId/results.csv

Answers a CSV file of any size, not JSON. Over MCP, read the campaign's calls one page at a time with get_batch_campaign.

POST /outbound-calls/batches/:campaignId/cancel

Changes a running campaign. Campaign actions are not available over MCP.

POST /outbound-calls/:outboundId/cancel

Changes a scheduled or running call. Call actions are not available over MCP.

POST /outbound-calls/:outboundId/retry

Places a new real call, at a cost. Call actions are not available over MCP.

POST /tools

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

PATCH /tools/:toolId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /tools/:toolId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /tools/:toolId/attach/:agentId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /tools/:toolId/detach/:agentId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

GET /secrets

Organization API keys never read the organization's secrets: the Atendia API answers 403 to both key types.

POST /secrets

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /secrets/:secretId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /agents/:agentId/widgets

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

PATCH /widgets/:widgetId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

DELETE /widgets/:widgetId

No organization API key can change this: «read» and «calls» keys only read it, and the Atendia API answers 403 to both. Change it in the console.

POST /calls

Internal-only server-to-server ingest; unsafe to expose to external MCP clients.

GET /agents/internal-config/:agentId

Internal runtime API requiring INTERNAL_API_KEY.

GET /agents/number-config/:phoneNumber

Internal runtime API requiring INTERNAL_API_KEY.

GET /public/widgets/:widgetId/config

Public browser widget API with origin-based CORS, not organization API-key MCP surface.

POST /public/widgets/:widgetId/sessions

Public browser call entrypoint; MCP should use admin widget APIs, not impersonate website visitors.

POST /public/widgets/:widgetId/sessions/:sessionId/end

Tied to browser session endToken, not a general MCP API.

POST /auth/*

Generated auth surface; not wrapped as domain MCP tools.

GET /docs /docs.json

Documentation/static UI, not a domain API tool/resource.

POST AI app /health, /agents/{id}/config, /voice/*, /kb/*

Internal server-to-server AI runtime APIs; they are consumed by Atendia API and should not be exposed directly over MCP.