How to Use the Firefish MCP in Claude Code

Q: How do I add the Firefish MCP Server to Claude Code?

Run claude mcp add --transport http firefish-mcp -- in your terminal, making sure to place your flags before the server name. Claude Code will save this to your /.claude.json config file.

Q: Can I pipe Firefish data from Claude Code to other CLI tools?

Yes, Claude Code can pull candidate lists with listcandidates and output them as raw JSON. You can easily pipe this data into local scripts, databases, or terminal utilities.

Q: How does Claude Code handle high-volume Firefish searches?

Claude Code uses listcandidates with pagination parameters to fetch large batches of profiles. It processes the data in chunks, keeping your terminal responsive while scanning thousands of records.

Q: How can I check active job adverts from the CLI?

Use Claude Code to call listadverts. It lists all active public postings, allowing you to quickly check live links, expiration dates, and job descriptions from your terminal.

Query your Firefish CRM directly from the command line using Claude Code to run instant candidate and placement reports.

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 Claude Code

Create your Vinkius account to connect Firefish to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run terminal-based candidate searches with Claude Code

The `list_candidates` tool lets you search your entire talent database straight from your shell. You can pipe candidate lists into grep, awk, or local JSON files without opening a browser. Claude Code processes these lists instantly, allowing you to filter by specific skills or application dates. It turns your terminal into a high-speed recruiting interface.

Automate CRM reporting using this MCP Server

The `list_placements` tool exposes your entire placement history to your terminal session. You can ask Claude Code to calculate placement velocities or generate monthly hiring reports in seconds. By combining this with `list_jobs`, you can quickly identify which open roles have been sitting empty for too long. It gives backend developers and technical sourcers a fast way to audit pipeline health.

Access deep contact and action logs instantly

The `list_actions` tool retrieves historical interaction logs for any candidate or client contact directly in your shell. You can review past touchpoints before jump-starting a new outreach campaign using this terminal-based MCP link. If you need to dive deeper, `get_contact` pulls up-to-date communication details in plain text. It allows you to script follow-ups or log notes without leaving your command-line workflow.

Setup guide

Set up Firefish MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see firefish-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Firefish transactions." It will automatically discover and invoke the available Firefish tools.

Terminal

claude mcp add --transport http firefish-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "firefish-mcp": {
      "type": "url",
      "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 Claude Code

Run `claude mcp add --transport http firefish-mcp -- ` in your terminal, making sure to place your flags before the server name. Claude Code will save this to your `~/.claude.json` config file.

Yes, Claude Code can pull candidate lists with `list_candidates` and output them as raw JSON. You can easily pipe this data into local scripts, databases, or terminal utilities.

Claude Code uses `list_candidates` with pagination parameters to fetch large batches of profiles. It processes the data in chunks, keeping your terminal responsive while scanning thousands of records.

Use Claude Code to call `list_adverts`. It lists all active public postings, allowing you to quickly check live links, expiration dates, and job descriptions from your terminal.

Your action histories and placement logs are processed in an ephemeral V8 Isolate sandbox. Vinkius secures your credentials, ensuring that sensitive interaction logs never persist on disk or expose your recruitment pipeline.

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