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.

Metadata

Release files for cheetah-firewall-mcp 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cheetah-firewall-mcp 1.2.0
File Size Uploaded
cheetah_firewall_mcp-1.2.0.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cheetah-firewall-mcp 1.2.0
File Interpreter ABI Platform
cheetah_firewall_mcp-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.6 kB

Release files / cheetah_firewall_mcp-1.2.0.tar.gz

Download URL cheetah_firewall_mcp-1.2.0.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c5f7dd8cbcd1160495c00d8a9103476e246c41d383d29ab0eafd3712f2adea6f
BLAKE2b-256 checksum
How to use checksums
6bdf10bb690896877012003509dd9c298a4a907982368956d8ec8071402ca914
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.2

Release files / cheetah_firewall_mcp-1.2.0-py3-none-any.whl

Download URL cheetah_firewall_mcp-1.2.0-py3-none-any.whl
Size 6.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2870c8387a77277e9497cd1bfacb86a54f56b7d3aed64b44cadd9b5580f005f7
BLAKE2b-256 checksum
How to use checksums
4ee29f0a1184d1b42e8c31c453afd2f8823477d2eba67a2d315760e979dfe866
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.2

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page