CLI + Agents

MCP server

Run gtmcli as an MCP server so AI agents in Claude Code, Codex, or any MCP-compatible client can validate and find emails natively.

Quick setup

Three commands. No JSON editing.

Install, login, connect
curl -fsSL https://dl.gtmcli.com/install.sh | sh && source ~/.zshrc
gtmcli login
gtmcli setup

TIP

gtmcli setup auto-configures MCP in both Claude Code and Claude Desktop. Restart Claude Code after running it.

Manual setup

If you prefer to configure manually, add gtmcli to your settings file:

MCP config
// ~/.claude/settings.json
{
  "mcpServers": {
    "gtmcli": {
      "command": "gtmcli",
      "args": ["mcp"]
    }
  }
}

Available tools

The MCP server exposes 6 tools. Your agent picks the right one automatically.

validate_emailValidate a single email addressemail0.25 credits
validate_batchValidate up to 500 emailsemails[]0.25 per valid
find_emailFind email by name + domainfirst_name, last_name, domain1 credit
find_batchFind up to 500 emailscontacts[]1 per found
check_creditsCheck credit balancenoneFree
account_infoGet org, tier, usagenoneFree

Tool details

validate_email

ParameterTypeDescription
emailreq
stringThe email address to validate.

validate_batch

ParameterTypeDescription
emailsreq
string[]Array of email addresses. Max 500.

find_email

ParameterTypeDescription
first_namereq
stringPerson's first name.
last_namereq
stringPerson's last name.
domainreq
stringCompany domain (e.g. stripe.com).

find_batch

ParameterTypeDescription
contactsreq
object[]Array of {first_name, last_name, domain}. Max 500.

Built-in intelligence

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

Validates before finding

Validation costs 0.25 credits. Finding costs 1 credit. Agent checks existing emails first.

Always batches

Sends 500 at a time instead of looping single calls. Faster and fewer API round-trips.

Checks credits first

Warns you before large operations that would use more than 50% of remaining credits.

Handles catch-alls

Flags catch-all domains and reports confidence scores. Does not count them as verified.

Reads and writes CSVs

Auto-detects email, name, and domain columns. Writes enriched results to new files.

NOTE

Want to use these instructions in ChatGPT, Codex, or other tools? See Agent instructions 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, export a clean CSV"

"Check my credits, then validate this list if I have enough"

Diagnostics

Run gtmcli doctor to verify everything is configured correctly:

Example output
❯ gtmcli doctor

  ✓ logged in          Acme Inc
  ✓ api reachable      https://api.gtmcli.com
  ✓ api key valid      Acme Inc, growth tier
  ✓ credits available  10000 remaining
  ✓ mcp configured     claude code / desktop
  ✓ binary installed   /usr/local/bin/gtmcli

  ✓ all good