Self-contained, zero-dependency Model Context Protocol (MCP 2025-06-18) STDIO Server implemented in Node.js (mcp.js) for 5-EVM Web3 pre-flight security, EVM calldata structural decoding, ERC-8021 Base Builder attribution, live RPC token honeypot scanning, BigInt DeFi MEV slippage math, and 24-vector Solidity auditing across Base (8453), Arbitrum (42161), Optimism (10), Polygon (137), and Ethereum (1).
This repository contains the complete, runnable STDIO MCP Server (mcp.js) packaged with a minimal Node 22 Alpine Dockerfile:
- Local MCP
2025-06-18Protocol Engine (mcp.js): Natively implementsinitialize,ping,tools/list,tools/call,resources/list,resources/read,prompts/list, andprompts/getover JSON-RPC 2.0 STDIO with zero external runtime dependencies. - Local Deterministic Web3 Tools (Zero Network Required):
ingravity_encodeErc8021Calldata— Validates hexadecimal EVM calldata locally and idempotently appends the Base ERC-8021 attribution suffix (bc_i26d7owr).ingravity_decodeEvmCalldataSelector— Structurally decodes standard 4-byte EVM selectors (approve,transfer,transferFrom,setApprovalForAll,permit,Permit2,multicall) and raw 32-byte ABI words locally.
- Local Input Validation & Session Receipt Caching: Strictly validates EVM addresses, chain IDs, and required schemas locally (
-32602JSON-RPC errors) and caches HMAC session receipts (X-Ingravity-Receipt-Token) to prevent duplicate spend. - Ingravity x402 v2 REST API Integrations (
/api/v1/*): Dispatches paid security analysis calls to the Ingravity verification backend settling per-call in Native Base USDC (eip155:8453) with zero API keys or subscriptions.
docker build -t ingravity-security-mcp .
docker run -i --rm ingravity-security-mcpAdd this entry to your MCP client configuration (claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"ingravity-security": {
"command": "npx",
"args": ["-y", "-p", "ingravity-security@1.3.2", "ingravity-mcp"],
"env": {
"INGRAVITY_AGENT_BUDGET": "0.10"
}
}
}
}| Variable | Description |
|---|---|
INGRAVITY_API_URL |
Override the default Ingravity REST API v1 base URL. |
INGRAVITY_AGENT_BUDGET |
Optional maximum USDC spend cap per call (X-Agent-Budget). |
INGRAVITY_PAYMENT_SIGNATURE |
Base64 EIP-3009 x402 v2 PAYMENT-SIGNATURE authorization. |
INGRAVITY_TX_HASH |
Optional settled Base USDC transfer hash (X-TX-HASH). |
INGRAVITY_RECEIPT_TOKEN |
Optional reusable session receipt token (X-Ingravity-Receipt-Token). |
| Tool Name | Execution | Description |
|---|---|---|
ingravity_encodeErc8021Calldata |
Local | Validates EVM hex calldata and idempotently appends Base ERC-8021 suffix (bc_i26d7owr). |
ingravity_decodeEvmCalldataSelector |
Local | Structurally decodes 4-byte EVM selectors and 32-byte ABI arguments (no risk verdict). |
| Tool Name | API Route | Full Tier | Essential Tier | Capabilities |
|---|---|---|---|---|
ingravity_fastPingAddressSafety |
GET /api/v1/fast-ping |
$0.01 |
$0.01 |
Binary SAFE / DANGER gate across 5 EVM chains (<= $0.05 bots). |
ingravity_inspectEvmTransactionFirewall |
POST /api/v1/tx-firewall |
$0.10 |
$0.10 |
Pre-sign calldata simulation, EIP-1967/1167 proxy check & revocation bundle. |
ingravity_scanTokenRugpullAndHoneypot |
POST /api/v1/token-rug-scanner |
$0.12 |
$0.04 |
Live 5-EVM RPC ERC-20 bytecode disassembly & honeypot detection. |
ingravity_computeDefiSlippageAndLiquidation |
POST /api/v1/defi-math-guard |
$0.10 |
$0.04 |
48-step exact BigInt AMM slippage, MEV sandwich & perp liquidation math. |
ingravity_auditSolidityContract |
POST /api/v1/audit-solidity |
$0.85 |
$0.35 |
Deterministic 24-vector Solidity static audit with 4-gate anti-noise filter. |
ingravity_generateMultiContractProtocolDossier |
POST /api/v1/protocol-dossier |
$12.00 |
$3.50 |
Multi-contract (1–20 files) cross-reentrancy & ERC-4626/oracle invariants. |
ingravity_simulateDeepExploitAndWhitehatBounty |
POST /api/v1/deep-exploit-bounty |
$45.00 |
$9.50 |
Flash-loan exploit simulation, live TVL check & unsigned Safe-Harbor plan. |
- Resources:
ingravity://docs/supported-chains— Canonical 5-EVM chain IDs and Base USDC settlement contract.ingravity://docs/x402-settlement— Zero-custody EIP-3009 x402 v2 settlement guide.
- Prompts:
pre_sign_transaction_check— Structured workflow to decode and inspect EVM calldata before signing.pre_swap_token_check— Two-step honeypot and AMM slippage checklist before swapping ERC-20 tokens.
In addition to the standalone MCP server (mcp.js), the package exports IngravitySecurityActionProvider, ingravityElizaPlugin, and encodeErc8021Calldata from index.js:
npm install ingravity-securityimport { IngravitySecurityActionProvider } from "ingravity-security";
const provider = new IngravitySecurityActionProvider({
walletProvider: evmWalletProvider,
maxSpendUsdc: 0.10,
enableReceiptCache: true
});npm test- Zero Custody: Never holds private keys or requests ERC-20
approve(). - Base Builder Code:
bc_i26d7owr(ERC-8021). - License: MIT