KosmoKrator

communication

Aircall MCP Integration for Vercel AI SDK

Connect Aircall to Vercel AI 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 Vercel AI SDK

Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts.

Create an MCP client that starts or connects to the KosmoKrator gateway for the selected integration. The gateway is local, scoped to this integration, and starts with --write=deny so Vercel AI SDK can inspect read-capable tools without receiving write access by default.

Aircall MCP Config for Vercel AI SDK

Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.

{
  "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 Vercel AI SDK

Vercel AI 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 Vercel AI SDKClient-level gateway setup.