Apicrate

PyPI version License: MIT Python 3.10+

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

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

claude mcp add apicrate -- apicrate-mcp

export APICRATE_API_KEY=ac_usr_your_key_here

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

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

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

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

IP Geolocation

Countries

Postal Codes

Timezones

Hashing

Bible

Email Risk

QR Code

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: [email protected]?"
• "Find postal codes within 10km of Berlin's center"

Configuration

Credits & Pricing

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

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