Tomba Agent Plugins

БесплатноНе проверен

Provides email discovery, verification, enrichment, and company research through a remote MCP server.

автор: tomba-io

GitHub Embed

Описание

Provides email discovery, verification, enrichment, and company research through a remote MCP server.

README

Tomba Agent Plugins

Agent plugins for Tomba remote MCP server — providing email discovery, verification, enrichment, and company research across multiple AI coding assistants.

Supported Platforms

Platform	Plugin Path	Auth Method
Generic / Multi-agent	`.agents/plugins/`	Bearer token or API headers
Claude (Desktop & Code)	`.claude-plugin/`	Bearer token
Cursor AI	`.cursor-plugin/`	`X-Tomba-Key` / `X-Tomba-Secret` headers
VS Code (GitHub Copilot)	`.vscode/`	Bearer token (prompted)
Windsurf	`.windsurf-plugin/`	Bearer token
Zed	`.zed-plugin/`	Bearer token
ChatGPT (OpenAI API)	`.chatgpt-plugin/`	Bearer token
Codeium	`.codeium-plugin/`	Bearer token
Gemini CLI	`.gemini-plugin/`	Bearer token

MCP Server

Endpoint: https://mcp.tomba.io/mcp
Transport: Streamable HTTP (JSON-RPC 2.0)
Docs: docs.tomba.io/llm/remote-mcp/introduction

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

Option 1: Bearer Token (Recommended)

Encode your credentials as base64:

echo -n 'ta_your_api_key:ts_your_secret_key' | base64

Use the result as:

Authorization: Bearer <base64_token>

Option 2: API Headers

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

Setup

1. Get API Credentials

Sign up at app.tomba.io/auth/register
Get your API key (ta_xxx) and secret (ts_xxx) from app.tomba.io/api
Copy .env.example to .env and fill in your credentials

2. Configure Your Platform

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

Run:

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

Cursor AI

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"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "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}"
      }
    }
  }
}

Windsurf

Add to Windsurf MCP settings (~/.codeium/windsurf/mcp_config.json):

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

Zed

Add to Zed settings.json:

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

ChatGPT (OpenAI Responses API)

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",
        "headers": {
          "Authorization": "Bearer YOUR_TOMBA_BASE64_TOKEN"
        },
        "require_approval": "never"
      }
    ],
    "input": "Find all emails for tomba.io"
  }'

Codeium

Add to Codeium MCP settings:

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

Gemini CLI

Add to ~/.gemini/settings.json:

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

Tomba CLI

The Tomba CLI provides direct terminal access to the same capabilities.

# Install
curl -sSL https://releases.tomba.io/install.sh | sh

# Authenticate
tomba login

# Usage
tomba search --target "example.com"
tomba finder --target "example.com" --first "John" --last "Doe"
tomba verify --target "[email protected]"
tomba enrich --target "[email protected]"
tomba linkedin --target "https://linkedin.com/in/profile"
tomba phone-finder --email "[email protected]"
tomba reveal --query "SaaS companies in San Francisco"

Contributing

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

License

MIT

from github.com/tomba-io/agent-plugins

Установка Tomba Agent Plugins

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/tomba-io/agent-plugins

FAQ