npm install -g prospeo-cli

npm install -g prospeo-cli

# If 'prospeo' is not found after install, add npm global bin to PATH:
export PATH="$(npm root -g)/../bin:$PATH"
# Add that line to ~/.zshrc or ~/.bashrc to make it permanent

# Set your API key (get it at https://prospeo.io/dashboard/api)
export PROSPEO_API_KEY="your-api-key"

# Verify
prospeo account info

prospeo person enrich --api-key "your-key" --linkedin-url "..."   # per-command flag
prospeo login                                                       # interactive, stores in ~/.prospeo/config.json

# Enrich a single person
prospeo person enrich --linkedin-url "https://linkedin.com/in/jdoe" --pretty
prospeo person enrich --email "john@acme.com"
prospeo person enrich --first-name "Eva" --last-name "Kiegler" --company-website "intercom.com"
prospeo person enrich --linkedin-url "..." --enrich-mobile --only-verified-mobile

# Bulk enrich up to 50 persons
prospeo person bulk-enrich \
  --data '[{"identifier":"1","linkedin_url":"https://linkedin.com/in/jdoe"},{"identifier":"2","email":"jane@stripe.com"}]' \
  --only-verified-email

# Search 200M+ contacts
prospeo person search \
  --filters '{"person_seniority":{"include":["Vice President","C-Suite"]},"company_industry":{"include":["Software Development"]}}' \
  --page 1 --pretty

# Enrich a single company
prospeo company enrich --website "stripe.com" --pretty
prospeo company enrich --linkedin-url "https://linkedin.com/company/stripe"
prospeo company enrich --name "Salesforce" --website "salesforce.com"

# Bulk enrich up to 50 companies
prospeo company bulk-enrich \
  --data '[{"identifier":"1","company_website":"intercom.com"},{"identifier":"2","company_website":"stripe.com"}]'

# Search 30M+ companies
prospeo company search \
  --filters '{"company_funding":{"stage":["Series A","Series B"]},"company_location_search":{"include":["United States"]}}' \
  --pretty

# Get exact location strings for search filters
prospeo suggestions location --query "new york"
prospeo suggestions location --query "united states"

# Get exact job title strings for search filters
prospeo suggestions job-title --query "head of sales"
prospeo suggestions job-title --query "vp engineering"

prospeo account info --pretty
# → {"current_plan":"GROWTH","remaining_credits":4850,"used_credits":150,"next_quota_renewal_date":"..."}

--pretty          Pretty-printed JSON
--fields a,b,c    Return only specified top-level fields
--quiet           No output, exit code only
--api-key <key>   Override PROSPEO_API_KEY for this command

{
  "mcpServers": {
    "prospeo": {
      "command": "npx",
      "args": ["prospeo-cli", "mcp"],
      "env": {
        "PROSPEO_API_KEY": "your-api-key"
      }
    }
  }
}