How to Use the Findymail MCP in Claude Code

Q: How do I install the Findymail MCP Server in Claude Code?

Run the claude mcp add command with the server transport details. Make sure to pass your API key as an environment variable or header. Once configured, the CLI agent will have immediate access to all search and verification tools.

Q: How does the agent handle slow-running lead searches?

The agent uses getleadsearchstatus to poll the API until the search is complete. Once ready, it retrieves the complete dataset. This prevents your terminal session from hanging during large queries.

Pipe verified B2B leads and phone numbers directly into your terminal tools using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Findymail MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-driven prospecting with Claude Code

This MCP Server lets you run `search_leads` directly from your shell to build complex prospecting queries. Forget web interfaces when building lead lists. Claude Code pulls data and pipes the output straight into your terminal tools. You can easily format the output as JSON or CSV. Because it runs entirely in the terminal, you can feed the results directly into other CLI utilities or database seeding scripts.

Scriptable email verification inside the CLI

Keep your database clean by using `verify_email` via the MCP connection to check addresses on the fly. Doing this prevents you from loading bad data into your mail servers. If you need to find an address from scratch, the agent runs `find_email` using the target's name and domain. This lets you build fast, automated verification pipelines directly in your terminal sessions.

Automated domain and profile enrichment

Get full context on any domain without leaving your shell by calling `enrich_company` to pull company profiles. This is perfect for verifying targets before you import them into your database. When you need direct phone numbers, the agent calls `find_phone` to grab direct lines. This makes it simple to feed clean, multi-channel contact data straight into your backend systems.

Setup guide

Set up Findymail 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 findymail-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http findymail-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 Findymail 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": {
    "findymail-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 Findymail. 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 Findymail 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 Findymail MCP in Claude Code

Run the `claude mcp add` command with the server transport details. Make sure to pass your API key as an environment variable or header. Once configured, the CLI agent will have immediate access to all search and verification tools.

Yes, you can script the execution using headless mode. The agent can trigger `search_leads` and use `get_lead_search_data` to fetch results on a schedule. This is perfect for setting up daily or weekly lead generation pipelines.

Ask the agent for your current balance in the terminal. It will execute `get_credits` or `get_credits_summary` using this MCP Server and print the exact numbers directly in your shell. You can easily check this before launching large search jobs.

The agent uses `get_lead_search_status` to poll the API until the search is complete. Once ready, it retrieves the complete dataset. This prevents your terminal session from hanging during large queries.

The connection runs through an isolated V8 sandbox container. Vinkius MCP hosting ensures your API tokens and retrieved contact details are never exposed to public networks or written to persistent shared storage. Everything is processed in transient memory and discarded immediately.

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