How to Use the AI Receptionist MCP in Claude Code

Manage voice agents, extract call analytics, and trigger bookings from your terminal 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 AI Receptionist MCP to Claude Code

Create your Vinkius account to connect AI Receptionist 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 AI Receptionist with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-Native Call Analytics

Running reports on your voice agents no longer requires a web portal. You drop into your terminal, ask Claude Code for yesterday's performance, and it hits the AI Receptionist MCP Server via `get_aireceptionist_analytics` to return the raw numbers. SREs can pipe this output directly into monitoring stacks. The CLI grabs active queues using `list_aireceptionist_conversations` and formats the JSON response into a clean bash output or writes it to a local log file for cron jobs to process.

Scripted Appointment Checks

Verifying calendar syncs happens entirely from the command line. You instruct the CLI to check for scheduling conflicts, and it fires off `list_aireceptionist_bookings` to pull the master list of upcoming appointments. If a specific time slot looks suspicious, the tool digs deeper. It runs `get_aireceptionist_booking` on the target ID, outputting the exact creation timestamps and caller details right to your standard output.

Validate Agent Training Data via MCP

DevOps teams can integrate voice agent training into their CI/CD pipelines. A simple script prompts Claude to run `list_aireceptionist_knowledge` and compare the live prompt instructions against your local repository. You catch drift before it affects callers. The CLI checks current webhook routing via `list_aireceptionist_webhooks` and fails the build if the production voice agent is pointing to deprecated staging endpoints.

Setup guide

Set up AI Receptionist 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 ai-receptionist-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http ai-receptionist-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 AI Receptionist 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": {
    "ai-receptionist-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 AI Receptionist. 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 AI Receptionist 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 AI Receptionist MCP in Claude Code

Run claude mcp add --transport http ai-receptionist-mcp -- in your terminal. Make sure all flags precede the server name to ensure the config saves correctly to ~/.claude.json.

You can schedule headless shell scripts that wake up, request metrics via the CLI, and pipe the resulting analytics payload into your central logging infrastructure.

The CLI queries your active routing table directly. It returns the exact URLs receiving call events so you can audit your integrations without leaving your SSH session.

All tool executions return structured data. You get clean JSON arrays for active calls and individual booking objects that are easy to parse with jq or similar Unix utilities.

Headless execution routes your booking times, caller names, and transcript chunks through a zero-trust Vinkius container. The ephemeral sandbox processes the request and instantly wipes the memory state, preventing local caching of sensitive PII.

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