KosmoKrator

communication

Aircall MCP Integration for Claude Agent SDK

Connect Aircall to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

8 functions 6 read 2 write Manual OAuth token auth
Submit Aircall feedback View package source

Connect Aircall to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Aircall MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-aircall": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=aircall",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=aircall --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Aircall instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Aircall Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Aircall integration catalog.

MCP toolSource functionTypeDescription
integration__aircall__aircall_list_calls aircall.aircall_list_calls Read List calls from Aircall with optional filters. Supports filtering by date range, direction (inbound/outbound), user ID, phone number, and tags. Returns paginated call records.
integration__aircall__aircall_get_call aircall.aircall_get_call Read Retrieve detailed information about a specific call in Aircall by its ID. Returns call details including duration, direction, status, recording, and contact information.
integration__aircall__aircall_list_contacts aircall.aircall_list_contacts Read List contacts from Aircall with optional search and pagination. Search by name, phone number, or email. Returns contact details including phone numbers and emails.
integration__aircall__aircall_create_contact aircall.aircall_create_contact Write Create a new contact in Aircall. Provide at least a first name or last name, and one phone number or email.
integration__aircall__aircall_update_contact aircall.aircall_update_contact Write Update an existing contact in Aircall. Provide the contact ID and the fields to update.
integration__aircall__aircall_list_users aircall.aircall_list_users Read List all users in the Aircall account. Returns user details including name, email, availability, and assigned phone numbers.
integration__aircall__aircall_list_numbers aircall.aircall_list_numbers Read List all phone numbers in the Aircall account. Returns number details including the phone number, country, type, and assigned users.
integration__aircall__aircall_get_current_user aircall.aircall_get_current_user Read Retrieve the currently authenticated Aircall user. Returns user details including name, email, and availability status.

Related Aircall Pages

Aircall CLIUse direct JSON commands instead of MCP discovery. Aircall MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.