How to Use the Firefish MCP in Windsurf

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

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, use the Settings UI in Windsurf under Cascade to add the endpoint. Cascade will automatically discover all tools like listcandidates upon connection.

Q: How does Windsurf handle high-volume Firefish candidate searches?

Windsurf uses the listcandidates tool to pull paginated lists of profiles directly into your session context. Cascade then reads the data to filter, sort, and flag candidates based on your specific parameters.

Q: Can I create new profiles directly from the IDE?

Absolutely. The createcandidate tool lets you pass raw resume data directly from your workspace to insert a new record into your CRM, saving you from manual browser entry.

Run your entire recruiting pipeline inside Windsurf by letting Cascade autonomously source candidates and update placements.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Firefish MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run autonomous candidate screening in Windsurf

The `list_candidates` tool pulls raw talent profiles directly into your editor environment so Cascade can evaluate them against open roles. You don't have to manually click through the CRM to find matching resumes anymore. Once Cascade identifies the best fits, it chains the `list_jobs` tool to find open requisitions and prepares the pipeline. This MCP Server lets your IDE handle the tedious matching work while you focus on interviews.

Map placement data to your local codebase

The `list_placements` tool exposes active hiring pipelines directly to Windsurf so Cascade can analyze conversion metrics. This MCP integration lets your agent pull placement histories, identify bottlenecks, and update internal trackers in one go. If a candidate changes status, Cascade triggers `get_candidate` to verify their profile before updating your local database. It keeps your local recruitment dashboards perfectly in sync with the live CRM.

Manage jobs and companies without leaving Cascade

The `get_job` tool retrieves active job requirements so Cascade can automatically write targeted outreach copy or update internal documentation. You get the raw job details injected directly into your active prompt context. Combine this with `get_company` to let Cascade build complete company profiles during your research phase. It handles all the API calls behind the scenes while you review the final output.

Setup guide

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

mcp_config.json

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

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, use the Settings UI in Windsurf under Cascade to add the endpoint. Cascade will automatically discover all tools like `list_candidates` upon connection.

Yes, Cascade excels at chaining tools sequentially. You can ask Cascade to find a job opening with `list_jobs`, get the company info via `get_company`, and draft a candidate intro without prompting it at each step.

Windsurf uses the `list_candidates` tool to pull paginated lists of profiles directly into your session context. Cascade then reads the data to filter, sort, and flag candidates based on your specific parameters.

Absolutely. The `create_candidate` tool lets you pass raw resume data directly from your workspace to insert a new record into your CRM, saving you from manual browser entry.

Yes, your candidate records, placement histories, and job data are processed securely. Vinkius runs the server in an isolated sandbox, meaning your API tokens and recruitment data never leak to external third parties.

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