sentinel-mcp

MCP (Model Context Protocol) server for SENTINEL — a pre-execution transaction safety oracle for autonomous AI agents. Lets any MCP-compatible client (Claude Desktop, Cursor, Windsurf, or any other agent that speaks MCP) check whether a transaction is safe to sign, before signing it, and pays for the check autonomously via x402 — no human in the loop, no API key, no subscription.

Independent, standalone package. Distributed via PyPI and the official MCP Registry (plus downstream aggregators: mcp.so, glama.ai, smithery.ai) — not tied to any single agent framework or requiring anyone's approval to use.

What it checks

• Contract security (honeypots, hidden owner/mint functions, active blacklist functions, proxy patterns, etc.) — via GoPlus
• A real buy/sell simulation against the token's live DEX pair — via honeypot.is
• Transaction simulation (does the call actually succeed) — via Alchemy
• Prior history: has this exact contract been flagged before, by any other agent?
• Deployer wallet track record (transaction count as a freshness signal)
• For ambiguous cases: a second opinion from an LLM council (Claude + GPT-4o-mini)

Returns a SAFE / UNSAFE / UNKNOWN verdict, a 0–100 risk score, and a cryptographically signed (ed25519) receipt.

Install

pip install sentinel-mcp

Configure

Set an environment variable with a Base wallet's private key (holding USDC on Base):

export AGENT_WALLET_PRIVATE_KEY="0x..."

Use with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "sentinel": {
      "command": "sentinel-mcp",
      "env": {
        "AGENT_WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Use with any other MCP client

sentinel-mcp

Runs over stdio, the standard MCP transport for local server processes.

Cost

$0.005 USDC per check, on Base mainnet, paid automatically via x402 from the configured wallet. No trial, no free tier — the price itself is the friction, by design.

Links

• Live methodology — exactly how a verdict is computed, published and machine-readable.
• Aggregate stats — track record across all callers, updated live.
• Report an outcome — free endpoint to report back what actually happened after acting on a verdict.

Related

• sentinel-agentkit-provider — the same safety check as a Coinbase AgentKit action provider.

License

MIT