CLI

The official Data Legion CLI lets you enrich, search, and discover person and company data directly from the terminal. It’s fully async, outputs JSON to stdout (logs to stderr), and works as both a human-friendly tool and an AI agent backend. AI coding agents like Claude Code, Cursor, OpenClaw, Cline, and Aider can call it directly as a shell tool.

Installation

brew install datalegion-ai/tap/datalegion-cli

pip install datalegion-cli

uv pip install datalegion-cli

Requires Python 3.11+.

Authentication

Sign in with your Data Legion account (admin or developer role). The CLI opens a sign-in link; confirm the code it shows, and it stores a key for this machine, encrypted on disk:

datalegion-cli login

Each machine gets its own key, named with a random id (such as cli-3f9a2c7e) that the CLI keeps in its config, so nothing about the machine is sent. Pass --device <name> for a readable label.
Signing in again on the same machine replaces its key. See and disconnect each one on the Connected Apps page.
--team-id <id> picks the team when your account has several; --no-browser prints the link to open on another device.

To use an API key instead (for example in CI), set it in the encrypted config store or an environment variable:

datalegion-cli config set api_key legion_your_key_here

export LEGION_API_KEY=legion_your_key_here

Person

Enrichment

Look up a person by email, phone, social URL, name, or other identifiers.

# By email
datalegion-cli person enrich --email jane.doe@example.com

# By phone
datalegion-cli person enrich --phone "+15551234567"

# By social URL
datalegion-cli person enrich --social-url https://linkedin.com/in/janedoe

# By name and company
datalegion-cli person enrich --name "Jane Doe" --company "Acme Corp"

# By first/last name with location context
datalegion-cli person enrich --first-name Jane --last-name Doe \
  --company Acme --city "San Francisco" --state california

# Return multiple matches with confidence scores
datalegion-cli person enrich --name "Jane Doe" --company Acme \
  --multiple --min-confidence high --limit 5

# Return specific fields only
datalegion-cli person enrich --email jane@example.com \
  --fields full_name,job_title,company_name

# Read input from stdin
echo '{"email": "jane@example.com"}' | datalegion-cli person enrich --stdin

All person enrich flags:

Flag	Description
`--email` / `-e`	Email address
`--phone` / `-p`	Phone number
`--social-url`	Social profile URL (e.g. LinkedIn)
`--linkedin-id`	LinkedIn numeric ID
`--legion-id`	Legion ID
`--email-hash`	SHA-256, SHA-1, or MD5 email hash
`--name` / `-n`	Full name
`--first-name`	First name
`--last-name`	Last name
`--company` / `-c`	Company name or domain
`--title`	Job title
`--city`	City
`--state`	State
`--country`	Country
`--school`	School name
`--birth-date`	Birth date (YYYY-MM-DD)
`--address`	Full address string
`--postal-code`	Postal/ZIP code
`--multiple` / `-m`	Return multiple matches
`--limit` / `-l`	Max results (default: 2)
`--min-confidence`	Minimum confidence: `high`, `moderate`, `low`
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--required`	Comma-separated required fields
`--titlecase`	Title-case text fields in response
`--stdin`	Read JSON payload from stdin

Search (Beta)

Query people using SQL syntax. The query is a positional argument.

datalegion-cli person search \
  "SELECT * FROM people WHERE job_title ILIKE '%engineer%' AND state = 'california'" \
  --limit 25

Flag	Description
`--limit` / `-l`	Max results (default: 10)
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--titlecase`	Title-case text fields in response

Discovery (Beta)

Find people using a natural language query; the CLI returns matches plus the generated_query it ran.

datalegion-cli person discover \
  "software engineers in San Francisco who know Rust" --limit 10

Flag	Description
`--limit` / `-l`	Max results (default: 10)
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--titlecase`	Title-case text fields in response

Company

Enrichment

Look up a company by domain, name, ticker, social URL, or other identifiers.

# By domain
datalegion-cli company enrich --domain google.com

# By ticker
datalegion-cli company enrich --ticker GOOGL

# By name
datalegion-cli company enrich --name "Alphabet Inc"

# By name with industry qualifier
datalegion-cli company enrich --name "Mercury" --industry "financial services"

# Return multiple matches
datalegion-cli company enrich --name Google --multiple --limit 5

All company enrich flags:

Flag	Description
`--domain` / `-d`	Company domain
`--name` / `-n`	Company name
`--ticker` / `-t`	Stock ticker symbol
`--social-url`	Social profile URL (e.g. LinkedIn company page)
`--linkedin-id`	LinkedIn numeric ID
`--legion-id`	Legion ID
`--industry`	Industry (narrows name matching)
`--multiple` / `-m`	Return multiple matches
`--limit` / `-l`	Max results (default: 2)
`--min-confidence`	Minimum confidence: `high`, `moderate`, `low`
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--required`	Comma-separated required fields
`--titlecase`	Title-case text fields in response
`--stdin`	Read JSON payload from stdin

Search (Beta)

Query companies using SQL syntax. The query is a positional argument.

datalegion-cli company search \
  "SELECT * FROM companies WHERE industry = 'software development' AND legion_employee_count > 50" \
  --limit 20

Flag	Description
`--limit` / `-l`	Max results (default: 10)
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--titlecase`	Title-case text fields in response

Discovery (Beta)

Find companies using a natural language query.

datalegion-cli company discover \
  "fintech startups in New York with under 50 employees"

Flag	Description
`--limit` / `-l`	Max results (default: 10)
`--fields`	Comma-separated fields to include
`--exclude`	Comma-separated fields to exclude
`--titlecase`	Title-case text fields in response

Utilities

Utility commands are free and don’t consume credits.

Clean Fields

Normalize emails, phones, names, domains, and other fields. Pass a JSON payload as a positional argument or via stdin.

# Positional JSON argument
datalegion-cli utility clean \
  '{"email": "  JANE.DOE+work@GMAIL.COM  ", "phone": "(555) 123-4567", "domain": "https://www.Google.com/about"}'

# From stdin
echo '{"email": "test@GMAIL.COM"}' | datalegion-cli utility clean --stdin

Flag	Description
`--stdin`	Read JSON fields from stdin
`--region`	Default phone region (default: `US`)

Hash Email

Generate privacy-preserving email hashes (SHA-256, SHA-1, MD5). The email is a positional argument.

datalegion-cli utility hash jane@example.com

Validate

Check data format and get cleaning suggestions before enrichment.

datalegion-cli utility validate \
  --email "not-an-email" --phone "+15551234567" --domain "google.com"

Flag	Description
`--email`	Email to validate
`--phone`	Phone to validate
`--name`	Name to validate
`--domain`	Domain to validate
`--social-url`	Social URL to validate
`--company`	Company name to validate
`--ticker`	Ticker symbol to validate
`--stdin`	Read JSON from stdin

Report a Data Issue

Flag an inaccuracy on a person or company record so the Data Legion team can review it. No credit cost. Include at least one of --correct or --comment.

datalegion-cli utility report person \
  --legion-id abc123 --issue-type outdated \
  --issue-level field --field job_title \
  --observed "CTO" --correct "CEO"

datalegion-cli utility report company \
  --legion-id xyz789 --issue-type duplicate \
  --comment "Same company as legion_id def456"

Flag	Description
`--legion-id`	Legion ID of the record (required)
`--issue-type`	incorrect, outdated, misattributed, frankenstein, not_a_real_person (person only), or duplicate
`--issue-level`	record, group, or field (default: record)
`--field`	Group or field name, for group/field level issues
`--observed`	The incorrect value you observed
`--correct`	The correct value, if known
`--comment`	Free-form description of the issue

Account

Check Credit Balance

datalegion-cli credits balance

View Usage History

datalegion-cli credits usage --from 2026-03-01 --to 2026-03-26

Agent Integration

The CLI is designed for AI agent workflows. Claude Code, Cursor, OpenClaw, Cline, Aider, and other AI coding agents can invoke it as a shell tool, with no MCP configuration needed. All structured output goes to stdout as JSON, while logs and progress indicators go to stderr, so agents and scripts can parse results directly.

# Pipe to jq
datalegion-cli person enrich --email jane@example.com | jq '.full_name'

# Pipe from stdin
echo '{"email": "jane@example.com"}' | datalegion-cli person enrich --stdin

# Quiet mode (suppress all non-JSON output)
datalegion-cli --quiet person enrich --email jane@example.com

The CLI and MCP server are complementary. Use MCP for native tool-call integration with AI assistants. Use the CLI when you need shell access, scripting, or want a zero-config option that any agent can call via bash.

Global Flags

Global flags go before the subcommand (datalegion-cli --quiet person enrich ...); placed after it, they are rejected as unknown options.

Flag	Description
`--verbose` / `-v`	Enable debug logging
`--quiet` / `-q`	Suppress all log output
`--help`	Display command help

Auto-Update

The CLI monitors GitHub releases and can self-update.

# Check for updates
datalegion-cli update --check

# Install updates
datalegion-cli update

# Show current version
datalegion-cli version

Credits

CLI commands consume credits at the same rate as the corresponding REST API endpoints. Utility commands are free.

Rate Limits

The same rate limits apply to CLI requests as to direct API calls.

Getting Started

Person Data

Company Data

Data Quality

Data Standardization

SDKs

Integrations

Installation

Authentication

Person

Enrichment

Search (Beta)

Discovery (Beta)

Company

Enrichment

Search (Beta)

Discovery (Beta)

Utilities

Clean Fields

Hash Email

Validate

Report a Data Issue

Account

Check Credit Balance

View Usage History

Agent Integration

Global Flags

Auto-Update

Credits

Rate Limits

Resources

​Installation

​Authentication

​Person

​Enrichment

​Search (Beta)

​Discovery (Beta)

​Company

​Enrichment

​Search (Beta)

​Discovery (Beta)

​Utilities

​Clean Fields

​Hash Email

​Validate

​Report a Data Issue

​Account

​Check Credit Balance

​View Usage History

​Agent Integration

​Global Flags

​Auto-Update

​Credits

​Rate Limits

​Resources

Installation

Authentication

Person

Enrichment

Search (Beta)

Discovery (Beta)

Company

Enrichment

Search (Beta)

Discovery (Beta)

Utilities

Clean Fields

Hash Email

Validate

Report a Data Issue

Account

Check Credit Balance

View Usage History

Agent Integration

Global Flags

Auto-Update

Credits

Rate Limits

Resources