How to Use the Fountain MCP in Windsurf

Q: How do I configure the Fountain MCP server inside Windsurf?

Add the server configuration directly to your /.codeium/windsurf/mcpconfig.json file. Once you save, Cascade immediately auto-discovers the twelve recruiting tools.

Q: Can Windsurf update applicant notes using Fountain?

No, the current version lets you read data using listapplicantnotes but does not support writing new notes. Cascade can read the discussion history to help you make decisions.

Q: Can I filter candidates by specific job openings?

Yes. Cascade uses the ID from listopenings to filter candidates via listapplicants, giving you a clean list of people who applied for that specific role.

Q: How does this setup protect applicant personally identifiable information?

Candidate PII retrieved via getapplicant is processed entirely within Vinkius's isolated sandbox. The Vinkius MCP setup ensures no applicant names, phone numbers, or emails are stored on external servers or used to train public models.

Get Cascade to pull recruiting funnels and schedule sessions instantly with this Windsurf 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 Fountain MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-map hiring pipelines in Windsurf

The `list_funnel_stages` tool pulls your live hiring steps directly into Cascade so your agent can track where candidates get stuck. Windsurf uses this endpoint to map out your recruitment bottlenecks without manual queries. Cascade reads the stage IDs, matches them with `list_applicants`, and flags candidates who have been sitting in the phone-screen stage for over 48 hours. You get a clear list of stuck applicants without opening a browser.

Track open positions and job board status

The `list_openings` tool exposes your active job slots so your IDE can audit your hiring footprint. Windsurf analyzes these openings alongside `list_job_posts` to verify which positions are currently live on external boards. Instead of jumping between tabs, tell Cascade to check if your newest warehouse role is active. The agent pulls the metadata, compares it to your active posts, and confirms the status in your chat panel.

Coordinate interviews from your editor

The `list_interview_sessions` tool retrieves scheduled slots directly into your workspace. Windsurf reads this calendar data to find open times and matches them against incoming applicant profiles. Cascade uses `get_applicant` to pull contact info and links it to the upcoming session. Your agent handles the scheduling lookup, saving you from constant context switching during high-volume hiring sprints.

Setup guide

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

mcp_config.json

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

Add the server configuration directly to your `~/.codeium/windsurf/mcp_config.json` file. Once you save, Cascade immediately auto-discovers the twelve recruiting tools.

No, the current version lets you read data using `list_applicant_notes` but does not support writing new notes. Cascade can read the discussion history to help you make decisions.

You configure your authentication token once in the Windsurf config. After that, Cascade handles the authentication headers behind the scenes for every query via the MCP connection.

Yes. Cascade uses the ID from `list_openings` to filter candidates via `list_applicants`, giving you a clean list of people who applied for that specific role.

Candidate PII retrieved via `get_applicant` is processed entirely within Vinkius's isolated sandbox. The Vinkius MCP setup ensures no applicant names, phone numbers, or emails are stored on external servers or used to train public models.

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