How to Use the JustCall MCP in Windsurf

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

Open your mcpconfig.json file in your Windsurf directory and add the server configuration under the mcpServers key. Paste your Vinkius endpoint token for authentication. Once you save, click the refresh button in the Windsurf MCP panel, and Cascade will instantly discover all 12 phone and messaging tools.

Let Windsurf autonomously pull call logs, send text follow-ups, and manage your customer contacts directly within your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JustCall MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger SMS Workflows Autonomously with this MCP Server

This JustCall MCP Server lets Cascade handle your post-call follow-ups autonomously. When you finish a call, Cascade can automatically use `list_calls` to find the session details, then pull the contact's record with `get_contact` to see their communication preferences. It does this in one go without stopping to ask you for permission at every step. Once Cascade knows who you talked to, it can immediately write and queue a text using `send_message`. You do not need to copy phone numbers back and forth or open a separate web app just to send a quick confirmation text.

Sync Directories with this MCP Integration

This JustCall MCP Server automates customer directory management directly inside your editor. With this integration, Windsurf runs through your contact records using `list_contacts` to find outdated entries. If it finds a missing lead, it creates a clean record right away using `create_contact` based on your project files or meeting notes. Cascade handles the entire sequence behind the scenes. It grabs your current team directory with `list_team_users` to assign ownership of the new contact to the right account manager, keeping your sales records clean and up to date.

Live Call Log Auditing and Verification

This JustCall MCP Server lets you verify call durations and look up specific conversation IDs without opening a browser. Cascade can inspect your phone lines by calling `list_account_numbers` to see active numbers, then pull live call records using `get_call_details` to check performance metrics. If a client disputes a billing item or a support ticket, Cascade chains these tools together to pull the exact timestamp and duration. It formats the data cleanly in your editor so you can resolve issues without leaving your code.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "justcall-alternative-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 JustCall. 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 JustCall 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 JustCall MCP in Windsurf

Open your `mcp_config.json` file in your Windsurf directory and add the server configuration under the `mcpServers` key. Paste your Vinkius endpoint token for authentication. Once you save, click the refresh button in the Windsurf MCP panel, and Cascade will instantly discover all 12 phone and messaging tools.

Yes, Windsurf can handle this easily. When you prompt Cascade to follow up with a customer, it uses the `send_message` tool to dispatch SMS or MMS texts directly through your account. You can even have it check `get_message_details` to verify the delivery status of your message.

No, Windsurf is built to execute multi-tool sequences autonomously. If you ask it to update a phone record, it can search with `list_contacts`, read the details with `get_contact`, and update or create a record using `create_contact` in a single execution chain. You do not have to approve each individual step.

Ask Cascade to show your active numbers. It will trigger the `list_account_numbers` tool to fetch your profile lines, then match them with your team members using `list_team_users` to show you who owns which phone line.

All interactions with your phone records, messages, and contacts run inside an isolated V8 sandbox. Vinkius uses an ephemeral, zero-trust execution model, meaning your call metadata and SMS contents are never stored on Vinkius servers. Everything is piped directly to your local editor session using a single secure token.

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