Enrichr

enrichrapi-mcp

MCP (Model Context Protocol) server for Enrichr — exposes Enrichr's 50 billed utilities to AI coding assistants like Claude Desktop, Cursor, VS Code, and any other MCP client.

One install. One key when you are ready. Validate emails (syntax + MX, not mailbox), parse phones, geolocate IPs over HTTPS, decode JWTs, sign webhooks, parse cron expressions, convert currencies, generate QR codes, count LLM tokens, and the rest of the catalog.

Fastest path: install first, start free

You do not need an Enrichr API key just to launch the MCP server. Start it, browse the live catalog, and use the signup tool to create a key when you want billed utilities. The raw key is returned once; verify the email address to unlock the 1,000 free calls/month allowance and recovery.

# recommended: no global install
uvx enrichrapi-mcp

Then ask your MCP client to:

1. list_catalog to see the live tool catalog.
2. signup with your email address if you do not already have a key.
3. Save the returned enr_... key, add it as ENRICHR_API_KEY, and restart the server.
4. Use account_usage before bulk work. If the free allowance is exhausted, account_options reports whether prepaid checkout is available and start_checkout can return the server-controlled Stripe Checkout URL.

No purchase is required to start. Enrichr signup does not create a metered subscription.

Install

# uvx — recommended, no global install needed
uvx enrichrapi-mcp

# or pipx
pipx install enrichrapi-mcp
enrichrapi-mcp

# or pip in a venv
pip install enrichrapi-mcp

Prefer to create the key outside the MCP client? The public signup endpoint is available directly:

curl -X POST https://enrichrapi.dev/v1/account/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

Configure your MCP client

Claude Desktop

You can launch without ENRICHR_API_KEY for catalog/signup tools. After signup, add the returned key and restart the MCP server:

{
  "mcpServers": {
    "enrichr": {
      "command": "uvx",
      "args": ["enrichrapi-mcp"],
      "env": {
        "ENRICHR_API_KEY": "enr_your_api_key"
      }
    }
  }
}

Cursor / VS Code (Cline)

Use the same command/config under the client's MCP settings UI. ENRICHR_API_KEY is optional for launch and required for billed utility calls.

Available tools (selected)

The server exposes 30+ MCP tools backed by the public Enrichr REST API. Highlights:

Tool	What it does
list_catalog	Live billed catalog (outbound_io_only filter)
signup	Provision a new Enrichr API key without an existing key
account_usage	Remaining free-tier calls + prepaid balance
account_options	Whether purchases are live + top-up amount
start_checkout	Stripe Checkout URL for the server top-up
call_enrichr	Invoke any catalog or account path by name
enrich_email	Syntax + optional MX DNS; disposable flags (not mailbox)
enrich_email_batch	Up to 100 emails; billed per item; MX deduped
validate_domain	Format + DNS A + MX (not mailbox)
validate_domain_batch	Up to 100 domains; billed per item
enrich_phone	E.164 normalization + line-type detection
enrich_ip	HTTPS country / region / city / ISP geolocation
convert_currency	ECB rates, daily
convert_timezone	DST-aware IANA timezone conversion
convert_units	length/weight/temp/area/volume
validate_credit_card	Luhn + network detection (number is never logged)
validate_iban	MOD-97 checksum, 77 countries
validate_vat	Live VIES check for EU VAT numbers
check_password_breach	HIBP k-anonymity, never sends plaintext
count_llm_tokens	tiktoken for OpenAI; approximations for 25+ other models
jwt_decode	Decode + optional HMAC verify (HS256/384/512)
webhook_sign	HMAC sign with templating (Stripe-style)
webhook_verify	Constant-time HMAC verify
cron_next	Next N runs of a 5-field cron / @daily etc.
generate_qr	base64 PNG + data URI
generate_password	secrets-module backed, with entropy estimate
billing_portal	Open a Stripe Billing Portal session
rotate_api_key	Atomically rotate the Enrichr key (old key revoked)

Full endpoint list: https://enrichrapi.dev/llms.txt

Pricing

• First 1,000 calls/month free after email verification.
• After that: most endpoints $0.00001/call (QR, postal, profanity, address, classify, …); email/phone/IP $0.0001; VAT/IBAN $0.0005; contact cleaner $0.001/row.
• Prepaid credits are server-controlled; the public site currently offers $10 prepaid credits at https://enrichrapi.dev/billing.
• This API will not do mailbox SMTP, USPS/geocode, trained NLP, or unpublished latency SLOs.
• Live catalog: https://enrichrapi.dev/v1/catalog

Repository

Source: https://github.com/crisjonblvx/enrichrapi-mcp

MCP Registry name: io.github.crisjonblvx/enrichr-api

License

MIT