MCP
Give your AI agent a phone number
Connect the MCP server and your agent can get a number, make and receive calls, and send and receive messages. All it takes is an API key. MCP tools and the REST API work with the same key and the same permissions.
01
Connection details
| Item | Value |
|---|---|
| URL | https://studio-gateway.zerocall.kr/mcp |
| Transport | Streamable HTTP (stateless, JSON responses) |
| Authentication | API key in the x-api-key header |
| Method | POST. GET and DELETE /mcp return 405. |
API keys are issued in the console. For how to get one, see step 1 of the quickstart.
02
What your agent can do
It covers numbers, calls and messages. Use MCP tools and the REST API together with the same API key.
| Task | How |
|---|---|
| Get a number | You get one 070 number when you sign up; on a paid plan, add more with the MCP tool issue_number. Add numbers |
| Make calls | Submit an AI outbound call with the MCP tool create_ai_outbound_call. Tool list |
| Receive calls | Assign an AI agent to a number and it answers calls to that number. Results arrive via the CALL_COMPLETED webhook. Number assignment |
| Send messages | Send SMS, LMS and MMS with the chat API. During a call, the agent's messaging tool can send a link. Send a message |
| Receive messages | Messages from customers arrive via the MESSAGE_RECEIVED webhook. Event list |
| Get results | Get outbound call results with get_ai_outbound_call or the AI_OUTBOUND webhook. |
03
Claude Code
Add it with one line in your terminal. Then check the connection inside Claude Code with /mcp.
claude mcp add --transport http kat https://studio-gateway.zerocall.kr/mcp --header "x-api-key: <API key>"04
Cursor
Add it to .cursor/mcp.json in your project or to mcp.json in your user settings.
{
"mcpServers": {
"kat": {
"url": "https://studio-gateway.zerocall.kr/mcp",
"headers": {
"x-api-key": "<API key>"
}
}
}
}05
ChatGPT · Gemini · GitHub Copilot · Windsurf
Enter the four values below in the screen or config file for adding a remote MCP server. Key names in config files differ by client.
Name kat
Transport Streamable HTTP
URL https://studio-gateway.zerocall.kr/mcp
Header x-api-key: <API key>| Client | Where to add it |
|---|---|
| GitHub Copilot (VS Code) | servers in .vscode/mcp.json. Set type to http as in the example below. |
| Windsurf | mcpServers in mcp_config.json. The URL key is serverUrl. |
| Gemini CLI | mcpServers in settings.json. The URL key is httpUrl. |
| ChatGPT | The screen for adding a remote MCP server (connector). First check that you can add an x-api-key header. |
{
"servers": {
"kat": {
"type": "http",
"url": "https://studio-gateway.zerocall.kr/mcp",
"headers": { "x-api-key": "<API key>" }
}
}
}Each product may change its client config format. If the connection fails, also check that product's remote MCP documentation.
06
MCP tools
The MCP server currently exposes five tools. Each tool pairs with a REST API that does the same thing.
| Tool | What it does | Equivalent REST |
|---|---|---|
| list_outbound_agents | Lists outbound agents (direction OUTBOUND) and their registered input schema. | GET /group/{groupId}/agent?direction=OUTBOUND |
| create_ai_outbound_call | Submits an AI outbound call. idempotencyKey is required. Use the same value when you retry. | POST /group/{groupId}/ai-outbound/calls (Idempotency-Key) |
| get_ai_outbound_call | Gets the call, analysis and settlement status. | GET /group/{groupId}/ai-outbound/calls/{requestId} |
| list_ai_outbound_calls | Lists outbound calls. Page with cursor and limit. | GET /group/{groupId}/ai-outbound/calls |
| terminate_ai_outbound_call | Cancels an outbound call that has not been placed yet, or requests termination of a call in progress. | POST /group/{groupId}/ai-outbound/calls/{requestId}/termination |
- Every tool takes a
groupId. You can omit it if the API key has only one group. - Permissions, limits, idempotency and error codes are the same as REST.
- Failures come back as an
isErrorresult in the formcode: message. - An outbound call immediately returns a
requestIdand its accepted status. After the call ends, get the result withget_ai_outbound_callor theAI_OUTBOUNDwebhook.
07
Before you start
create_ai_outbound_callplaces real calls. Charges may apply. Turn on tool approval in your client.- Use the same
idempotencyKeywhen you retry. A new value is accepted as a new call. - The API key goes into the config file as-is. Do not commit config files to a repository.
- APIs other than SMS sending are available to groups on the Business plan or groups separately granted access. Scope and permissions
Get started
Give the AI you built today
a phone number
Use the Personal plan free for 7 days after you sign up. Get a number and take your first call.
Already have an account? Log in
The console (app.katcloud.kr) is in Korean.
- 01Create an account
- 02Get a phone number
- 03Connect your agent and take the first call
