Skip to main content
Glama
calldata-guardian

calldata-guardian

by Baneado98

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:

  1. Decode the 4-byte selector into arguments — turn 0x095ea7b3…ffff… into "approve UNLIMITED to 0xDEAD".

  2. Live on-chain context the calldata alone doesn't carry — is to a 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)?

  3. Token metadata — resolve decimals/symbol so 1.157e59 is 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

approve / increaseAllowance with an infinite amount — the #1 drainer vector

✉️ Gasless permit

EIP-2612 permit & Permit2 — your signature alone grants spend rights

🃏 setApprovalForAll

hands an operator control of ALL your NFTs in a collection

💸 Drains

transferFrom, transfer, ownership transfers, multicall bundles that hide an approval

👻 EOA spender

an approval where the spender is a plain wallet — a classic phishing pattern

🔗 Upgradeable / non-contract target

to is a proxy (swappable logic) or has no code at all

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 decode

Chains

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 tools
decode_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

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools use a consistent verb_noun pattern with snake_case (decode_calldata and preview_transaction), adhering to a predictable naming convention.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Per-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.
      5
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Non-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.
      9
      65 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Evaluates 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Pre-transaction security gate for Pharos AI agents that analyzes contract bytecode and on-chain state to assess risks like upgradeability and honeypot controls.
      MIT