Copy page

Guides

MPP via MCP Server

Overview

The Tomba Remote MCP Server at mcp.tomba.io now includes MPP-powered tools alongside the standard API-key-authenticated tools. MPP tools let AI agents pay per request using an InFlow buyer key instead of a Tomba API subscription.

Auth Method	Tools Prefix	Header	Use Case
Tomba API Key	domain_search, email_finder, ...	Authorization: Bearer <token>	Subscription users
InFlow MPP	mpp_domain_search, mpp_email_finder, ...	X-Inflow-Key: <key>	Pay-per-request agents

Available MPP MCP Tools

#	Tool	Description
1	mpp_domain_search	Find all emails associated with a company domain
2	mpp_email_finder	Find a person's email by name and company domain
3	mpp_email_verifier	Verify email deliverability and validity
4	mpp_email_enrichment	Enrich an email with full contact profile
5	mpp_email_count	Count available emails for a domain
6	mpp_author_finder	Find the author's email from an article URL
7	mpp_linkedin_finder	Resolve a LinkedIn profile URL to an email
8	mpp_phone_finder	Find phone numbers from email, domain, or LinkedIn
9	mpp_phone_validator	Validate a phone number (carrier, type, country)
10	mpp_similar_finder	Find similar company domains

Each MPP tool has the same input schema as its standard counterpart — the only difference is authentication and payment.

Setup

Prerequisites

1. Register a buyer account at sandbox.inflowpay.ai (testing) or app.inflowpay.ai (production)
2. Generate an InFlow API key from the dashboard

Claude Desktop

Code
{
    "mcpServers": {
        "tomba-mpp": {
            "url": "https://mcp.tomba.io/mcp",
            "headers": {
                "X-Inflow-Key": "your_inflow_api_key",
                "X-Inflow-Environment": "sandbox"
            }
        }
    }
}

Claude Code

Code
claude mcp add tomba-mpp \
  --transport http \
  --url https://mcp.tomba.io/mcp \
  --header "X-Inflow-Key: your_inflow_api_key" \
  --header "X-Inflow-Environment: sandbox"

Cursor

Add to .cursor/mcp.json:

Code
{
    "mcpServers": {
        "tomba-mpp": {
            "url": "https://mcp.tomba.io/mcp",
            "headers": {
                "X-Inflow-Key": "your_inflow_api_key",
                "X-Inflow-Environment": "sandbox"
            }
        }
    }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

Code
{
    "servers": {
        "tomba-mpp": {
            "url": "https://mcp.tomba.io/mcp",
            "headers": {
                "X-Inflow-Key": "your_inflow_api_key",
                "X-Inflow-Environment": "sandbox"
            }
        }
    }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

Code
{
    "mcpServers": {
        "tomba-mpp": {
            "serverUrl": "https://mcp.tomba.io/mcp",
            "headers": {
                "X-Inflow-Key": "your_inflow_api_key",
                "X-Inflow-Environment": "sandbox"
            }
        }
    }
}

ChatGPT

In ChatGPT settings, add an MCP connection:

• URL: https://mcp.tomba.io/mcp
• Header: X-Inflow-Key: your_inflow_api_key
• Header: X-Inflow-Environment: sandbox

Usage Examples

Once connected, you can use natural language to invoke MPP tools:

Find emails at a company

"Use mpp_domain_search to find all emails at stripe.com"

Find a specific person's email

"Use mpp_email_finder to find the email of John Smith at example.com"

Verify an email

"Use mpp_email_verifier to check if john@example.com is valid"

Enrich a contact

"Use mpp_email_enrichment to get full contact details for ceo@company.com"

Find phone numbers

"Use mpp_phone_finder to find the phone number for user@company.com"

How Payment Works

When an MPP tool is called:

1. The MCP server sends a request to agents.tomba.io/<endpoint>
2. The Tomba API returns a 402 Payment Required challenge
3. The MCP server creates a payment transaction with InFlow using your buyer key
4. InFlow processes the payment ($0.0098 USDC per request)
5. The MCP server retries with the payment credential
6. Data is returned to the AI agent

This entire flow happens automatically — the AI agent just calls the tool and gets results.

MPP vs Standard Tools

Feature	Standard Tools	MPP Tools
Authentication	Tomba API Key + Secret	InFlow Buyer Key
Pricing	Subscription plan	$0.0098 per request
Signup	Tomba account required	InFlow account only
Rate Limit	Based on plan	100 req/min
Tool Prefix	domain_search	mpp_domain_search
Same Data	Yes	Yes
Same Schema	Yes	Yes

Sandbox Testing

For testing, use the sandbox environment:

1. Register at sandbox.inflowpay.ai
2. Set X-Inflow-Environment: sandbox in your MCP config
3. All payments use test funds — no real charges
4. When ready for production, switch to app.inflowpay.ai and set environment to production