Get started

Quickstart

Validate an email or find a contact in under two minutes.

1. Get an API key

Sign up at gtmcli.com and create an API key from the dashboard. Or install the CLI:

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

2. Validate an email

Validate
curl -X POST https://api.gtmcli.com/v1/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "ceo@stripe.com"}'
Responsejson
{
  "email": "ceo@stripe.com",
  "status": "valid",
  "provider": "google"
}

TIP

Validation costs 0.25 credits for valid results only. Invalid, catchall, and disposable results are free.

3. Find an email

Find
curl -X POST https://api.gtmcli.com/v1/find \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Patrick", "last_name": "Collison", "domain": "stripe.com"}'
Responsejson
{
  "email": "pc@stripe.com",
  "status": "valid",
  "convention": "flast",
  "confidence": 1
}

TIP

Finding costs 1 credit for found results. Not-found results are free.

4. Connect to Claude Code

Run gtmcli setup to auto-configure MCP in Claude Code. Or add manually:

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

Restart Claude Code. Then ask it to validate an email to test.

NOTE

See the CLI reference for all commands, or MCP server for all available tools.