How to Use the Aircall MCP in Cursor

Build phone system integrations in Cursor using live Aircall data. Your AI agent queries real call logs while you write 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 Cursor

Create your Vinkius account to connect Aircall to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write scripts with Aircall MCP Server

Fetching recent phone activity relies on the `list_calls` tool. Cursor hits the API and pulls actual JSON payloads into your editor context. You stop guessing what the response structure looks like because the agent is reading the exact data right now. Building dashboards gets much faster when you have real metrics. The AI can write parsing logic based on a live `get_call_details` response. Your code works on the first try since it was written against production data rather than outdated documentation.

Sync numbers and team configurations

The MCP `list_numbers` tool returns your entire phone tree setup. Ask your editor to write a script that audits routing rules, and it will pull the live configuration first. Checking individual lines happens through `get_number_details`, which exposes voicemail and greeting settings. Mapping out agent queues requires `list_teams` and `list_users`. You can prompt the AI to generate an internal directory page, and it will populate the HTML with real names and availability statuses. You never have to mock up fake users again.

Automate contact management

Creating CRM sync scripts uses the `create_contact` tool. You tell Cursor to write a webhook handler, and it tests the payload structure by actually pushing a test contact to your account. Verifying the insert worked is as simple as running `search_contacts` with the new phone number. Bulk exports work through the `list_contacts` endpoint. The agent can write a Python script to paginate through your entire directory and save it to a local database. Everything runs directly through the MCP connection configured in your workspace.

Setup guide

Set up Aircall MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Aircall MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Aircall transactions." If the MCP tools are loaded correctly, Cursor will call the Aircall tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "aircall-mcp": {
      "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 Cursor

Create an mcp.json file in your project root directory. Add the Vinkius endpoint under the mcpServers key and turn on Agent mode in your chat panel.

Yes, the AI can add new entries using the provided tools. You should be careful when asking it to test creation scripts against your production account.

This integration only handles API interactions and data retrieval. Handling live voice traffic requires WebRTC and the native softphone application.

You only need your Vinkius endpoint token in the configuration file. We handle the actual API authentication behind the scenes.

We route your routing configurations and user directories through ephemeral zero-trust containers. The sandbox vanishes immediately after returning the data to your editor.

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