How to Use the Aircall MCP in Claude Code

Q: How do I configure the Aircall MCP Server in Claude Code?

Run claude mcp add --transport http aircall -- in your terminal. This command updates your /.claude.json configuration file and instantly exposes the tools.

Pipe Aircall call logs and team availability directly into your terminal scripts with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aircall MCP to Claude Code

Create your Vinkius account to connect Aircall to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Aircall with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless phone system audits via Claude Code

For SREs and DevOps engineers, UI dashboards are too slow. Claude Code connects directly to your phone infrastructure, letting you run `list_calls` and pipe the output to your local shell tools. You can ask this MCP Server to scan for failed connections, parse the output, and alert your team. No browser tabs, no heavy interfaces—just clean terminal execution.

Automated team routing updates from the CLI

Managing on-call rotations shouldn't require manual clicking. Claude Code lets you query your current phone distribution rules using `list_numbers` right from your terminal prompt using this MCP Server. It checks which teams are assigned to each line via `list_teams` and reports mismatches instantly. You can script these checks as part of your deployment pipelines to ensure support lines never go dark.

Fast terminal-based contact lookups

When a customer system alert triggers, you need their contact info immediately. Claude Code uses `search_contacts` to find the owner's phone number without making you open a CRM. If you need to verify their account status, the CLI tool triggers `get_user_details` to check which internal agent last spoke to them. It gives you the full context in seconds, right inside your terminal session.

Setup guide

Set up Aircall MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see aircall-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Aircall transactions." It will automatically discover and invoke the available Aircall tools.

Terminal

claude mcp add --transport http aircall-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Aircall MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "aircall-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Aircall. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Aircall now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Aircall MCP in Claude Code

Run `claude mcp add --transport http aircall -- ` in your terminal. This command updates your `~/.claude.json` configuration file and instantly exposes the tools.

Yes, you can pipe local data into Claude Code and have it run `create_contact` to populate your workspace. It handles the formatting and API requests headlessly.

This MCP connection manages execution queues sequentially. If you run a command that triggers `list_calls` across many pages, it processes the batches steadily to avoid hitting rate limits.

Yes, you can manage your environment variables and transport settings directly inside your local configuration file to customize how the CLI connects to the endpoint.

Your credentials reside inside Vinkius's secure, isolated V8 sandbox, meaning your local terminal environment never stores or exposes raw API keys. All data transit is encrypted using TLS 1.3 to block any interception.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript