Skip to main content

cheetah-firewall-mcp

MCP server that gives any MCP-capable agent a set of input-safety tools from cheetahsecurity.de, billed per call over x402 (USDC on Base) — with a free tier so it works out of the box:

Tool What it does
scan_prompt(text) Prompt-injection firewall — scan untrusted text before acting on it
check_url(url) URL / domain reputation — phishing & malicious-link signals
check_agent_trust(agent_address) On-chain trust score for another agent's Base wallet (PROCEED/CAUTION/BLOCK)
screen_counterparty(agent_address) AML / sanctions screening (OFAC + exposure + scam list) before sending funds (CLEAR/REVIEW/BLOCK)
check_skill(skill_md, urls, scripts, requested_permissions) Skill pre-install analysis — RCE/curl|bash, reverse shells, secret exfiltration, over-broad permissions before you install (VERIFIED/FAILED + violations)

Why: on an agent network, every post, reply, tool result or web page your agent reads is untrusted input. These tools let it check that input before it becomes action.

Install & run

# via uvx (no install)
uvx cheetah-firewall-mcp

# or pip
pip install cheetah-firewall-mcp
cheetah-firewall-mcp

Add to an MCP client (e.g. Claude Desktop / Claude Code mcp config):

{
  "mcpServers": {
    "cheetah-security": {
      "command": "uvx",
      "args": ["cheetah-firewall-mcp"]
    }
  }
}

That's it — the free tier gives every caller a daily allowance, no wallet required.

Paid mode (optional, unlimited)

When the free allowance runs out the endpoints return HTTP 402. To pay the micro-fee automatically (fractions of a cent per call), install the pay extra and point the server at a funded Base wallet:

pip install 'cheetah-firewall-mcp[pay]'
export X402_PRIVATE_KEY=0x...   # a Base (EVM) key with a little USDC
cheetah-firewall-mcp

Pricing (per call): scan_prompt ~$0.02 · check_url ~$0.01 · check_agent_trust ~$0.02 · screen_counterparty ~$0.05 · check_skill ~$0.05. The key stays in the process and is never logged.

Configuration

Env var Default Purpose
CHEETAH_BASE https://x402.cheetahsecurity.de service base URL
X402_PRIVATE_KEY Base wallet key for automatic paid mode (optional)
CHEETAH_HTTP_TIMEOUT 30 per-request timeout (seconds)

MIT licensed. Detection engines are self-hosted; the only third-party call is public RDAP for domain age.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cheetah_firewall_mcp-1.2.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cheetah_firewall_mcp-1.2.0-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file cheetah_firewall_mcp-1.2.0.tar.gz.

File metadata

  • Download URL: cheetah_firewall_mcp-1.2.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.2

File hashes

Hashes for cheetah_firewall_mcp-1.2.0.tar.gz
Algorithm Hash digest
SHA256 c5f7dd8cbcd1160495c00d8a9103476e246c41d383d29ab0eafd3712f2adea6f
MD5 7fc276e57e22da0a40ee289327f96c13
BLAKE2b-256 6bdf10bb690896877012003509dd9c298a4a907982368956d8ec8071402ca914

See more details on using hashes here.

File details

Details for the file cheetah_firewall_mcp-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cheetah_firewall_mcp-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2870c8387a77277e9497cd1bfacb86a54f56b7d3aed64b44cadd9b5580f005f7
MD5 c189e037d61de6a40895925e494e63ec
BLAKE2b-256 4ee29f0a1184d1b42e8c31c453afd2f8823477d2eba67a2d315760e979dfe866

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 files

1.1.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page