apicrate-mcp

ApiCrate MCP Server

  

Connect any MCP-compatible AI agent to 22 data tools across 9 domains — IP geolocation, email risk scoring, postal codes, countries, timezones, user-agent parsing, cryptographic hashing, Bible search, and QR code generation.

This package provides a local STDIO transport for the ApiCrate MCP server. It proxies tool calls from your MCP client to the hosted API, so your API key stays in an environment variable instead of a config file.

You can also connect directly to the hosted server via Streamable HTTP at https://api.apicrate.io/mcp/ — no install needed. See HTTP Setup below.

Quick Start

1. Get your API key

Sign up free at apicrate.io — no credit card required.

2. Install

pip install apicrate-mcp

Or run without installing:

uvx apicrate-mcp

3. Configure your client

<details open> <summary><strong>Claude Desktop</strong></summary>

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apicrate": {
      "command": "apicrate-mcp",
      "env": {
        "APICRATE_API_KEY": "ac_usr_your_key_here"
      }
    }
  }
}

</details>

<details> <summary><strong>Claude Code</strong></summary>

claude mcp add apicrate -- apicrate-mcp

Then set your key:

export APICRATE_API_KEY=ac_usr_your_key_here

Or add a .mcp.json to your project root:

{
  "mcpServers": {
    "apicrate": {
      "command": "apicrate-mcp",
      "env": {
        "APICRATE_API_KEY": "ac_usr_your_key_here"
      }
    }
  }
}

</details>

<details> <summary><strong>Cursor</strong></summary>

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "apicrate": {
      "command": "apicrate-mcp",
      "env": {
        "APICRATE_API_KEY": "ac_usr_your_key_here"
      }
    }
  }
}

</details>

<details> <summary><strong>Windsurf</strong></summary>

Add to ~/.codeium/windsurf/mcp_settings.json:

{
  "mcpServers": {
    "apicrate": {
      "command": "apicrate-mcp",
      "env": {
        "APICRATE_API_KEY": "ac_usr_your_key_here"
      }
    }
  }
}

</details>

Streamable HTTP (no install)

If your client supports Streamable HTTP, skip the install and connect directly:

{
  "mcpServers": {
    "apicrate": {
      "type": "streamableHttp",
      "url": "https://api.apicrate.io/mcp/",
      "headers": {
        "X-API-Key": "ac_usr_your_key_here"
      }
    }
  }
}

4. Verify

Ask your agent:

"What country has code DE?"

It should call apicrate-lookup-country and return information about Germany.

Tools

User Agents

| Tool | Description | Credits | |------|-------------|---------| | apicrate-parse-user-agent | Parse browser, OS, device & bot from a UA string | 2 | | apicrate-parse-user-agents-bulk | Batch parse up to 100 UA strings | 1/UA |

IP Geolocation

| Tool | Description | Credits | |------|-------------|---------| | apicrate-geolocate-ip | Country, city, ISP, ASN & VPN/Tor detection | 5 |

Countries

| Tool | Description | Credits | |------|-------------|---------| | apicrate-lookup-country | Full ISO 3166-1 record — capital, currencies, languages | 1 | | apicrate-search-countries | Filter by region, sub-region, or query | 3 | | apicrate-validate-country-codes | Validate up to 50 country codes in one call | 1/code |

Postal Codes

| Tool | Description | Credits | |------|-------------|---------| | apicrate-lookup-postal-code | Resolve to city, admin regions & coordinates | 2 | | apicrate-validate-postal-code | Check format validity and database existence | 1 | | apicrate-search-postal-codes | Search by prefix or place name | 3 | | apicrate-list-postal-systems | List all countries with postal code data | 2 | | apicrate-get-postal-system | Format, regex & examples for a country | 2 | | apicrate-validate-postal-codes-bulk | Batch validate up to 50 postal codes | 2/code | | apicrate-find-nearby-postal-codes | Find codes within a radius of a GPS point | 5 |

Timezones

| Tool | Description | Credits | |------|-------------|---------| | apicrate-get-timezone-info | Current time, UTC offset & DST status | 1 | | apicrate-convert-time | Convert time between two timezones | 1 |

Hashing

| Tool | Description | Credits | |------|-------------|---------| | apicrate-compute-hash | MD5, SHA-1, SHA-256, or SHA-512 | 1 | | apicrate-hash-password | bcrypt, scrypt, or argon2id | 2 |

Bible

| Tool | Description | Credits | |------|-------------|---------| | apicrate-get-bible-verse | Fetch a verse or range across 30+ translations | 1 | | apicrate-search-bible | Full-text search across translations | 3 |

Email Risk

| Tool | Description | Credits | |------|-------------|---------| | apicrate-check-email-risk | Syntax, MX, disposable, domain age, abuse list | 4 | | apicrate-check-email-risk-bulk | Bulk assess up to 10 emails | 4/email |

QR Code

| Tool | Description | Credits | |------|-------------|---------| | apicrate-generate-qr | Generate QR from text, URL, WiFi, vCard, email, SMS, or geo | 2 |

Example Prompts

Once connected, try these:

• "Where is IP 203.0.113.5 located?"
• "What city is postal code EC1A 1BB in?"
• "Parse this User-Agent string for me"
• "Convert 9am London time to Tokyo"
• "Hash this password with argon2id"
• "Look up John 3:16 in the NIV"
• "Is this email address risky: test@tempmail.com?"
• "Find postal codes within 10km of Berlin's center"

Configuration

| Environment Variable | Default | Description | |---------------------|---------|-------------| | APICRATE_API_KEY | (required) | Your API key from apicrate.io | | APICRATE_BASE_URL | https://api.apicrate.io | API base URL (for testing/self-hosted) | | APICRATE_TIMEOUT | 30 | HTTP request timeout in seconds |

Credits & Pricing

MCP tool calls consume credits from a daily pool, separate from REST API quota.

| Plan | Credits/day | Price | |------|-------------|-------| | Starter | 100 | Free | | Pro | 50,000 | $19/mo | | Enterprise | Unlimited | Custom |

Every response includes quota headers (X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset) so you always know your usage.

Development

# Clone the repo
git clone https://github.com/apicrateio/apicrate-mcp.git
cd apicrate-mcp

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Run the server locally
APICRATE_API_KEY=ac_usr_your_key apicrate-mcp

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT

Links

• ApiCrate Website
• API Documentation
• MCP Documentation
• Tool Reference
• Status Page
• Community