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.