How to Use the folk MCP in Windsurf

Q: How do I install the folk MCP Server in Windsurf?

Open your configuration at /.codeium/windsurf/mcpconfig.json or use the Cascade UI. Add the server details and hit refresh.

Q: Does the server work with Cascade's multi-step planning?

Cascade excels at this. It will naturally chain listgroups to find the right segment, then listcontacts to pull the targets.

Connect folk to Windsurf and let Cascade handle your CRM updates automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect folk MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync CRM Data Directly in Windsurf

This MCP Server connects your folk workspace directly to Windsurf. Cascade uses `list_groups` to find your specific recruiting or sales buckets without asking you to leave the editor. Once it knows the group, the agent triggers `list_contacts` to pull the exact list of people you need. You just tell Cascade to review the latest partnership leads, and it chains the right queries together in seconds.

Let Cascade Map Your Relationships

The `list_interactions` tool feeds your agent every touchpoint a specific person had with your team. Ask Windsurf to summarize a client's history before drafting an email, and Cascade does the heavy lifting. It grabs the base profile via `get_contact_details` and then runs `list_contact_notes` to build a complete picture. You skip the manual CRM search entirely while the agent writes a highly contextual message.

Automate Updates with the folk MCP Server

Updating a CRM sucks, so Windsurf does it for you. When you finish writing a script that scrapes leads, Cascade can pipe those results straight into folk using `create_contact`. You never touch the database interface. The agent parses the names, emails, and phone numbers from your active files and builds the records instantly.

Setup guide

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

mcp_config.json

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

Open your configuration at `~/.codeium/windsurf/mcp_config.json` or use the Cascade UI. Add the server details and hit refresh.

Yes. Cascade can read a list of emails in your workspace and run `create_contact` for each one.

You likely hit an API rate limit or passed an invalid contact ID. Tell Cascade to run `get_contact_details` first to verify the ID before calling `list_contact_notes`.

Cascade excels at this. It will naturally chain `list_groups` to find the right segment, then `list_contacts` to pull the targets.

Your contact phone numbers and interaction logs stay local to your machine. The MCP protocol routes data straight from the API to your active editor session, dropping it the second you close the window.

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