How to Use the Goodcall MCP in Windsurf

Q: How do I connect Goodcall to Windsurf Cascade?

You add the server configuration to your mcpconfig.json file under the mcpServers key. Once saved, Cascade auto-discovers all 13 MCP tools, allowing you to trigger actions like listing bookings or updating agents using natural language.

Q: Can Windsurf update my Goodcall receptionist instructions automatically?

Yes, Cascade uses the updateagent tool to modify agent prompts based on your instructions. It can read your local codebase rules and apply them directly to your live phone agent.

Q: Does the Goodcall integration with Windsurf support automated booking syncs?

Yes, Cascade can run a loop using listbookings to fetch new appointments and write them to your local database. It handles the entire data pipeline without requiring manual API calls.

Q: How do I verify that my phone agent is online?

You run checkgoodcallstatus through the Cascade panel. This tool returns a direct status check, confirming your AI receptionist is ready to take calls.

Manage your Goodcall AI receptionist and automate booking workflows directly from Windsurf using this MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Goodcall MCP to Windsurf

Create your Vinkius account to connect Goodcall 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 Goodcall with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate booking pipelines with Windsurf Cascade

The `list_bookings` tool retrieves scheduled appointments from your AI receptionist, feeding raw scheduling data straight to Cascade. When a customer books a slot, Cascade reads the calendar payload, identifies empty slots, and updates your internal database without you writing a single line of glue code. Cascade handles the pipeline, so you don't have to fiddle with manual API endpoints. Cascade uses this MCP server to check the status of your receptionist using `check_goodcall_status` before pulling any data. If the connection is solid, it schedules subsequent steps to sync your CRM or alert your team on Slack. You just set the goal and let Cascade do the heavy lifting.

Analyze customer calls without leaving the IDE

The `get_call_summary` tool extracts core details from customer conversations, giving Cascade immediate access to what your callers want. Instead of reading massive text blocks, your agent grabs the summary, detects common complaints, and drafts code fixes or FAQ updates on the spot. To get deep context, Cascade chains this with `get_transcript` to extract exact quotes from the call. If a caller reports a bug, Cascade creates a reproduction script in your editor based on the transcript. No manual copy-pasting required.

Dynamic agent updates based on live call analytics

The `update_agent` tool changes your virtual receptionist's behavior on the fly based on real call performance. When `get_analytics` flags a drop in booking rates, Cascade analyzes the trend and updates the agent's instructions to improve script compliance. This MCP Server exposes `list_agents` and `get_agent` so Cascade always knows your active configurations. If a specific agent underperforms, Cascade modifies its system prompt instantly. Your phone system adapts to customer behavior in real-time.

Setup guide

Set up Goodcall 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 Goodcall 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 Goodcall payment history." If connected, Cascade will call the Goodcall tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "goodcall-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 Goodcall. 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 Goodcall 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 Goodcall MCP in Windsurf

You add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Once saved, Cascade auto-discovers all 13 MCP tools, allowing you to trigger actions like listing bookings or updating agents using natural language.

Yes, Cascade uses the `update_agent` tool to modify agent prompts based on your instructions. It can read your local codebase rules and apply them directly to your live phone agent.

Yes, Cascade can run a loop using `list_bookings` to fetch new appointments and write them to your local database. It handles the entire data pipeline without requiring manual API calls.

You run `check_goodcall_status` through the Cascade panel. This tool returns a direct status check, confirming your AI receptionist is ready to take calls.

The server processes call transcripts and voice metadata inside an ephemeral V8 sandbox. Your raw transcript data from `get_transcript` is never stored on Vinkius servers, keeping customer conversations isolated and secure.

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