How to Use the AI Receptionist MCP in Windsurf

Q: How do I connect the AI Receptionist MCP Server to Windsurf?

Open your MCP panel and click Refresh, or edit /.codeium/windsurf/mcpconfig.json. Add the Vinkius endpoint under the mcpServers object and Cascade will auto-discover the booking tools.

Q: What call data does AI Receptionist expose to Windsurf?

You get full access to active queues via listaireceptionistconversations and specific transcript details when querying individual IDs.

Manage inbound calls and auto-book appointments directly inside Windsurf using Cascade's autonomous planning.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

End-to-End Call Management in Windsurf

Cascade connects straight to your telephony stack through the AI Receptionist MCP Server. You ask Windsurf to review yesterday's missed calls, and the agent automatically pulls the logs using `list_aireceptionist_conversations` before fetching specific transcripts with `get_aireceptionist_conversation`. If a caller requested an appointment but dropped off, Cascade doesn't wait for you. It reads the transcript context, extracts the requested time slot, and triggers `create_aireceptionist_booking` to secure the calendar event on its own.

Autonomous Performance Audits

Checking call metrics usually means logging into a dashboard. Now, you just tell your IDE to compile a weekly report. Cascade runs `get_aireceptionist_analytics` to pull response times, handle times, and resolution rates directly into your workspace. When you need to pipe those events elsewhere, Windsurf inspects your current routing via `list_aireceptionist_webhooks`. It verifies which endpoints receive call completion payloads and highlights any missing integrations in your codebase.

Live Agent Training Updates via MCP

Updating what your virtual receptionist knows happens right from your editor. Cascade queries existing training data via `list_aireceptionist_knowledge` to see how the system currently answers pricing or location questions. Your agent cross-references those articles against your actual source code or markdown files. If it spots an outdated business hour, it flags the discrepancy immediately so your inbound callers never get bad information.

Setup guide

Set up AI Receptionist MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my AI Receptionist payment history." If connected, Cascade will call the AI Receptionist tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ai-receptionist-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 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 Windsurf

Open your MCP panel and click Refresh, or edit ~/.codeium/windsurf/mcp_config.json. Add the Vinkius endpoint under the mcpServers object and Cascade will auto-discover the booking tools.

Yes. Cascade reads your prompt, checks availability, and executes `create_aireceptionist_booking` without needing manual approval for every step.

You get full access to active queues via `list_aireceptionist_conversations` and specific transcript details when querying individual IDs.

You can ask Cascade to audit recent interactions. It pulls the data, checks for failed resolutions, and lists the problematic transcripts in your terminal output.

The MCP Server passes raw conversation transcripts, caller IDs, and booking details through a zero-trust V8 Isolate Sandbox. Vinkius drops all connection data the moment the session ends, keeping your customer PII out of persistent third-party storage.

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