MCP Server

Run GTMCLI as an MCP (Model Context Protocol) server so AI agents in Claude Code, Codex, or any MCP-compatible client can validate and find emails natively.

Prerequisites

Install and login with the GTMCLI CLI first:

# Install (macOS / Linux)
curl -fsSL https://gtmcli.com/install.sh | sh

# Login (opens browser)
gtmcli login

Claude Code Setup

Add GTMCLI to your Claude Code MCP servers. Edit ~/.claude/settings.json:

{
  "mcpServers": {
    "gtmcli": {
      "command": "gtmcli",
      "args": ["mcp"]
    }
  }
}

Restart Claude Code. You should see GTMCLI tools available in your conversation.

Codex Setup

Codex supports MCP servers the same way. Add to your Codex config:

{
  "mcpServers": {
    "gtmcli": {
      "command": "gtmcli",
      "args": ["mcp"]
    }
  }
}

Available Tools

The MCP server exposes 6 tools your agent can call:

validate_email0.25 credits for valid results

Validate a single email address. Returns status (valid, invalid, catchall, disposable) and provider.

emailstringEmail address to validate
validate_batch0.25 credits per valid result

Validate up to 500 email addresses at once.

emailsstring[]Array of email addresses (max 500)
find_email1 credit per found result

Find someone's work email by their name and company domain.

first_namestringPerson's first name
last_namestringPerson's last name
domainstringCompany domain (e.g., stripe.com)
find_batch1 credit per found result

Find emails for up to 500 contacts at once.

contactsobject[]Array of {first_name, last_name, domain}
check_creditsFree

Check remaining credit balance. No parameters needed.

account_infoFree

Get account details including organization, tier, and usage.

Built-in Intelligence

The MCP server includes expert instructions that teach your agent GTM best practices automatically:

  • - Validates before finding (saves credits)
  • - Always uses batch operations (faster)
  • - Checks credits before large operations
  • - Understands catch-all domains and confidence scores
  • - Reads CSVs and writes enriched results back

Want to customize or use these instructions in other AI tools? See the Agent Instructions page for copy-paste prompts.

Example Prompts

Try these with Claude Code or Codex after connecting GTMCLI:

"Validate all the emails in contacts.csv and tell me how many are valid"
"Find the email for Sarah Chen at Stripe"
"Build me a list of 100 VPs of Sales at Series B SaaS companies. Find and validate their emails."
"Clean my HubSpot export - validate every email, find replacements for invalid ones, and export a clean CSV"
"Check my credits, then validate this list if I have enough"