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)
| File | Size | Uploaded | |
|---|---|---|---|
| cheetah_firewall_mcp-1.2.0.tar.gz | 5.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|