CLI + Agents

CLI reference

Validate and find emails from your terminal. Also runs as an MCP server for AI agents.

Install

One command. Installs the binary and updates your PATH.

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

Then login:

gtmcli login

TIP

Or run gtmcli setup after login to auto-configure MCP in Claude Code. No manual JSON editing.

Authentication

Auth commands

# Login (opens browser)
gtmcli login

# Check account
gtmcli whoami

# Logout
gtmcli logout

Credentials stored in ~/.gtmcli/config.json.

Setup

Auto-configure MCP in Claude Code and Claude Desktop.

Setup + diagnostics

# Auto-configure MCP for Claude Code
gtmcli setup

# Check everything is working
gtmcli doctor

Validate emails

Validate

# Single email
gtmcli validate user@company.com

# Batch from CSV (auto-detects email column)
gtmcli validate --file leads.csv

# Output: leads_validated.csv

StatusMeaningCost

validEmail exists and accepts mail0.25 credits

invalidEmail does not existFree

catchallDomain accepts all emailsFree

valid_catchallLikely real on catchall domain0.25 credits

disposableTemporary or throwaway addressFree

Find emails

Find

# Single lookup
gtmcli find --first Tim --last Cook --domain apple.com

# Batch from CSV (needs first_name, last_name, domain columns)
gtmcli find --file contacts.csv

# Output: contacts_found.csv

INFO

Finding costs 1 credit per found result. Not-found results are free.

Check credits

gtmcli credits

MCP server

Run as an MCP server so AI agents can use gtmcli tools directly.

gtmcli mcp

Or auto-configure with gtmcli setup. Manual config:

~/.claude/settings.jsonjson

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

NOTE

See MCP server for the full list of tools and example prompts.

CSV column detection

The CLI auto-detects columns from your CSV headers:

FieldRecognized headers

Emailemail, email_address, emailaddress

First namefirst_name, firstname, first name, first

Last namelast_name, lastname, last name, last

Domaindomain, company_domain, website

All commands

CommandDescription

gtmcli loginSign in via browser

gtmcli logoutRemove credentials

gtmcli whoamiShow account info

gtmcli setupConfigure MCP for Claude Code

gtmcli doctorCheck everything is working

gtmcli validateValidate an email or CSV

gtmcli findFind an email by name + domain

gtmcli creditsCheck credit balance

gtmcli mcpRun as MCP server

gtmcli helpShow help

gtmcli versionShow version