CLI Reference

The GTMCLI CLI lets you validate and find emails from your terminal. It also runs as an MCP server for AI agents like Claude Code and Codex.

Installation

Install with one command:

curl -fsSL https://gtmcli.com/install.sh | sh

Supports macOS (Apple Silicon + Intel) and Linux (x64 + ARM).

Authentication

# Login (opens browser)
gtmcli login

# Check who you're logged in as
gtmcli whoami

# Logout
gtmcli logout

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

Validate Emails

# Single email
gtmcli validate jeff@example.com

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

# Output: leads_validated.csv with email, status, provider

Status	Meaning	Cost
`valid`	Email exists and accepts mail	0.25 credits
`invalid`	Email does not exist	Free
`catchall`	Domain accepts all emails	Free
`valid_catchall`	Likely real on catchall domain	0.25 credits
`disposable`	Temporary/throwaway address	Free

Find Emails

# 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 with email, status, convention, confidence

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

Check Credits

gtmcli credits

MCP Server (AI Agents)

Run GTMCLI as an MCP server so AI agents can validate and find emails directly.

# Run MCP server (stdio)
gtmcli mcp

Claude Code Setup

Add to ~/.claude/settings.json:

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

Available Tools

validate_emailValidate a single email address

validate_batchValidate up to 500 emails at once

find_emailFind email by first name, last name, and domain

find_batchFind up to 500 emails at once

check_creditsCheck remaining credit balance

account_infoGet organization, tier, and usage stats

Built-in Intelligence

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

- Validates before finding (cheaper)
- Always batches operations (faster)
- Checks credits before large jobs
- Understands catchall domains
- Reads CSVs and writes results back

CSV Column Detection

The CLI auto-detects columns from your CSV headers:

Field	Recognized Headers
Email	email, email_address, emailaddress
First Name	first_name, firstname, first name, first
Last Name	last_name, lastname, last name, last
Domain	domain, company_domain, website