calldata-guardian
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@calldata-guardian decode 0x095ea7b3... on ethereum"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
calldata-guardian ✍️
Know what you're signing — before you sign it.
calldata-guardian is an MCP server and a pay-per-call x402 HTTP API. Give it a transaction's chain + to + data (calldata) + value and it returns a SAFE / REVIEW / DANGER verdict with a plain-English list of exactly what the transaction will do — flagging the dangerous things a wallet should never sign blindly.
⚠️ Read-only decode/safety screen, not a guarantee. calldata-guardian never holds a key and never broadcasts anything. It cannot decode every custom selector. Never sign a transaction you do not understand.
Why it exists (the moat)
A wallet/agent that "just looks at the calldata" still can't tell you the things that matter:
Decode the 4-byte selector into arguments — turn
0x095ea7b3…ffff…into "approve UNLIMITED to 0xDEAD".Live on-chain context the calldata alone doesn't carry — is
toa contract at all? is it an EIP-1967 upgradeable proxy whose logic can be swapped after you sign? is the approved spender/operator a known router or a random EOA (the classic phishing pattern)?Token metadata — resolve
decimals/symbolso1.157e59is shown as UNLIMITED.
calldata-guardian batches all of that and returns one verdict with the human "this will…" breakdown.
Related MCP server: chain-signer
What it flags
♾️ Unlimited approval |
|
✉️ Gasless permit | EIP-2612 |
🃏 setApprovalForAll | hands an operator control of ALL your NFTs in a collection |
💸 Drains |
|
👻 EOA spender | an approval where the spender is a plain wallet — a classic phishing pattern |
🔗 Upgradeable / non-contract target |
|
Use as an MCP server (free)
{
"mcpServers": {
"calldata-guardian": { "command": "npx", "args": ["-y", "calldata-guardian-mcp"] }
}
}Tools:
preview_transaction— full decode + risk verdict. Params:chain,to,data,value.decode_calldata— quick "what function is this?" decode. Params:to,data,chain.
Or connect over HTTP at POST /mcp.
Free HTTP API
GET /preview?chain=ethereum&to=0xTOKEN&data=0x095ea7b3...Returns the decoded actions, signals, and a SAFE/REVIEW/DANGER verdict.
Pay-per-call (x402)
The /pro/preview route is gated by x402. Your agent pays $0.15 USDC per call automatically — no sign-up, no API key. Settles on-chain (Base) to the operator wallet.
GET /pro/preview?chain=base&to=0x...&data=0x... # 402 → pay → full decodeChains
Ethereum · Base · BSC · Polygon · Arbitrum — all via public, key-free RPCs.
Part of the guardian set
npm-guardian · contract-auditor · rug-check · approval-guardian · calldata-guardian
Source & docs: github.com/Baneado98/calldata-guardian · MIT
Available Tools
2 toolsdecode_calldataA
Decode a single piece of EVM calldata (the 4-byte selector + arguments) into its function and parameters. For full risk context (is the spender an EOA? is to a proxy?), use preview_transaction instead. Returns the function name and decoded args for the known supply-chain-relevant selectors (approve, permit, setApprovalForAll, transfer, transferFrom, increaseAllowance, transferOwnership, multicall).
Inputs: to (required), data (required), chain.
preview_transactionA
Decode and explain an EVM transaction BEFORE signing it — the 'what am I about to sign?' check. Give it a chain + the transaction's to / data (calldata) / value and it returns a SAFE / REVIEW / DANGER verdict with a plain-English list of exactly what the transaction will do, flagging the dangerous things a wallet should never sign blindly: unlimited token approvals, EIP-2612 / Permit2 gasless permits, setApprovalForAll on NFTs, transferFrom drains, increaseAllowance top-ups, ownership transfers, multicall bundles that hide an approval, and calls to non-contract / upgradeable targets or approvals to a plain-wallet (EOA) spender. It also reads live on-chain context (is to a contract / proxy? is the spender an EOA?) and resolves token decimals so amounts are human-readable. Read-only; never signs or broadcasts. Use this whenever an agent is about to sign or relay a transaction it didn't fully construct. Chains: ethereum, base, bsc, polygon, arbitrum.
Inputs: chain (required), to (required), data, value.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools serve distinctly different purposes: decode_calldata provides basic parameter decoding, while preview_transaction offers a comprehensive risk assessment with live context. The descriptions clearly differentiate them, leaving no ambiguity.
Both tools use a consistent verb_noun pattern with snake_case (decode_calldata and preview_transaction), adhering to a predictable naming convention.
With only 2 tools, the set is slightly thin, but it covers the core functionality of calldata decoding and transaction preview without unnecessary bloat, making it appropriate for its focused scope.
The tool set covers the essential operations: basic decoding for known selectors and a full transaction preview with risk assessment and live on-chain context. There are no obvious gaps for the stated purpose of a calldata guardian.
Related MCP Connectors
Read-only crypto safety: token honeypot checks, EIP-712 signature decode, approval scans.
Use before signing an EVM tx or EIP-712 message: risk flags + verdict. Informational, no simulation
Decode supported token calls and flag recipient or amount mismatches; no wallet or safety verdict.
Check a tx, EIP-712 payload, text or Base token before your agent signs. Paid per call over x402.
Related MCP Servers
- AlicenseAqualityDmaintenancePer-transaction crypto trade validator for AI agents, validates trades with PROCEED/CAUTION/BLOCK verdicts, scans tokens for anomalies, detects rug pulls, and searches across DEXes. Powered by WaveGuard physics engine with deterministic PDE-based analysis.51MIT
- AlicenseAqualityDmaintenanceNon-custodial agent wallet with a transaction preflight that decodes an unsigned EVM tx and flags drain patterns (unlimited/large approval, approve-all, token & NFT transferFrom, proxy upgrade, on-chain permit, approvals hidden in multicall) before signing.965 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceEvaluates on-chain risk for Pharos agents before executing transactions, providing verdicts (safe/caution/dangerous) and risk-bounded execution plans via Foundry cast reads.MIT No Attribution
- AlicenseNot gradedqualityDmaintenancePre-transaction security gate for Pharos AI agents that analyzes contract bytecode and on-chain state to assess risks like upgradeability and honeypot controls.MIT