Skip to main content
Glama
tomba-io

Tomba Agent Plugins

Official
by tomba-io
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

Supported Platforms

Platform

Plugin Path

Auth Method

Generic / Multi-agent

.agents/plugins/

OAuth / Bearer / API headers

Claude (Desktop & Code)

.claude-plugin/

OAuth 2.0 (automatic)

Cursor AI

.cursor-plugin/

X-Tomba-Key / X-Tomba-Secret headers

VS Code (GitHub Copilot)

.vscode/

OAuth / Bearer (prompted)

Windsurf

.windsurf-plugin/

OAuth / Bearer

Zed

.zed-plugin/

OAuth / Bearer

ChatGPT (OpenAI API)

.chatgpt-plugin/

OAuth (plugin manifest)

Codeium

.codeium-plugin/

OAuth / Bearer

Gemini CLI

.gemini-plugin/

OAuth / Bearer

Related MCP server: fetchcraft-mcp

MCP Server

Available Tools

Tool

Description

domain_search

Find all emails for a company domain

email_finder

Discover a person's email via name + company

email_verifier

Validate email deliverability, MX, SMTP

email_enrichment

Get full contact and company profiles

email_count

Count public emails for a domain

author_finder

Extract author email from article URLs

linkedin_finder

Convert LinkedIn profiles to verified emails

phone_finder

Retrieve validated phone numbers

phone_validator

Verify phone numbers with carrier details

technology_finder

Identify website technology stacks

similar_finder

Discover competitor/lookalike companies

companies_search

Query company database by attributes

All tool definitions are maintained in shared/tools.json as a single source of truth.

Resources

Resource

URI

Description

Account Info

tomba://account

Current account information and usage

Domain Stats

tomba://domain/{domain}/stats

Email statistics for a domain

Usage Stats

tomba://usage

API usage statistics

Prompts

12 pre-built prompts for common workflows:

Prompt

Description

lead-research

Research a company and find key contacts for outreach

competitor-analysis

Analyze competitors including tech stack, team structure, and contacts

email-verification

Verify a list of email addresses

find-person

Find a specific person's email at a company

content-outreach

Find authors and content creators for outreach campaigns

account-based-marketing

Build comprehensive ABM campaigns with multi-stakeholder targeting

investor-research

Research VCs/investors, portfolio companies, and find decision makers

hiring-outreach

Source candidates from target companies for recruiting

partnership-research

Identify strategic partners and integration opportunities

market-research

Conduct industry analysis across multiple companies

sales-territory-mapping

Build territory plans with account prioritization and stakeholder mapping

due-diligence

Comprehensive company analysis for investment, acquisition, or partnership

Authentication

Method 1: OAuth 2.0 (Recommended)

Just provide the MCP URL — no API keys or headers needed. Your MCP client opens a browser for authorization automatically via RFC 9728 discovery.

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Supported by: Claude Desktop, and any MCP client with OAuth discovery support.

Method 2: Bearer Token

For clients that don't support OAuth. Encode your credentials as base64:

echo -n 'ta_your_api_key:ts_your_secret_key' | base64

Use the result as:

Authorization: Bearer <base64_token>

Method 3: API Headers

For Cursor and clients that support custom headers:

X-Tomba-Key: ta_your_api_key
X-Tomba-Secret: ts_your_secret_key

Setup

1. Choose Your Auth Method

OAuth (Claude Desktop) — No setup needed. Just add the URL and authorize in your browser when prompted.

API Keys (other clients):

  1. Sign up at app.tomba.io/auth/register

  2. Get your API key (ta_xxx) and secret (ts_xxx) from app.tomba.io/api

  3. Copy .env.example to .env and fill in your credentials

2. Configure Your Platform

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Claude Desktop opens your browser automatically for authorization. Tokens refresh silently.

Run:

claude mcp add tomba --transport http --url https://mcp.tomba.io/mcp \
  --header "Authorization: Bearer YOUR_BASE64_TOKEN"

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp",
      "transport": "http",
      "headers": {
        "X-Tomba-Key": "ta_your_api_key",
        "X-Tomba-Secret": "ts_your_secret_key"
      }
    }
  }
}

Option A — OAuth (if supported):

{
  "servers": {
    "tomba": {
      "type": "http",
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token (prompted):

{
  "inputs": [
    {
      "id": "tomba-bearer",
      "type": "promptString",
      "description": "Tomba Bearer Token (base64 of ta_api_key:ts_secret_key)",
      "password": true
    }
  ],
  "servers": {
    "tomba": {
      "type": "http",
      "url": "https://mcp.tomba.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:tomba-bearer}"
      }
    }
  }
}

Option A — OAuth (if supported):

{
  "mcpServers": {
    "tomba": {
      "serverUrl": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token:

{
  "mcpServers": {
    "tomba": {
      "serverUrl": "https://mcp.tomba.io/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_BASE64_TOKEN"
      }
    }
  }
}

Option A — OAuth (if supported):

{
  "context_servers": {
    "tomba": {
      "settings": {
        "url": "https://mcp.tomba.io/mcp"
      }
    }
  }
}

Option B — Bearer token:

{
  "context_servers": {
    "tomba": {
      "settings": {
        "url": "https://mcp.tomba.io/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_BASE64_TOKEN"
        }
      }
    }
  }
}

Use the MCP tool type in the OpenAI Responses API:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "tools": [
      {
        "type": "mcp",
        "server_label": "tomba",
        "server_url": "https://mcp.tomba.io/mcp",
        "require_approval": "never"
      }
    ],
    "input": "Find all emails for tomba.io"
  }'

Option A — OAuth (if supported):

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token:

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_BASE64_TOKEN"
      }
    }
  }
}

Option A — OAuth (if supported):

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp"
    }
  }
}

Option B — Bearer token:

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "tomba": {
      "url": "https://mcp.tomba.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BASE64_TOKEN"
      }
    }
  }
}

Rate Limits

Every API response includes rate limit headers:

Header

Description

RateLimit-Policy

Rate limit policy definition

RateLimit

Current remaining quota and reset time

x-daily-request-left

Remaining daily requests

x-minute-request-left

Remaining requests this minute

x-minute-reset-seconds

Seconds until minute limit resets

Contributing

See CONTRIBUTING.md for guidelines on adding new platform plugins.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-hunter

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Wraps the Hunter.io email finder and verification API, enabling email lookup and verification via MCP.
    6 npm
    MIT

  • fetchcraft-mcp

    emily397
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables B2B research by finding verified work emails, extracting contacts, detecting tech stacks, and profiling DNS and SaaS, all through a suite of MCP tools.
    -

  • emailfinder-mcp

    xinxinhenaixin
    A
    license
    A
    quality
    D
    maintenance
    MCP server for emailfinder.dev that enables AI assistants to find verified professional email addresses via name/domain, LinkedIn URLs, company domains, roles, and email validation.
    5
    19 npm
    MIT

  • mcp-postmark

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables sending single or batch emails via the Postmark API through an MCP server.
    MIT