smarts.md

Live docs for every verified smart contract. Point your AI agent at one URL and ask about any contract on Ethereum, Base, Arbitrum, Optimism, or Polygon.

• Web: https://smarts.md
• MCP endpoint: https://smarts.md/mcp (Streamable HTTP, MCP spec 2025-03-26)
• MCP docs: https://mcp.smarts.md
• Discovery: https://smarts.md/.well-known/mcp.json

Add to your AI agent

# Claude Code
claude mcp add --transport http smarts https://smarts.md/mcp

Cursor / Windsurf / Cline / Claude Desktop: see https://mcp.smarts.md for the per-client config snippet.

Tools

tool	what
get_contract_info	metadata + classification + adapter tag
get_contract_source	source index, file content, or grep across verified Solidity source
get_erc20_info	supply, price, market cap, issuer, admin controls
get_governance_timeline	privileged-event history: role changes, upgrades, pauses, blacklisting, minter config
get_recent_events	recent decoded contract events, optionally filtered by event name
get_uniswap_v3_pool	pair, fee, price, liquidity, tick, TVL
inspect_address	EOA vs contract, balance, nonce, reverse ENS
read_contract_state	any view/pure function with args

Curated shortcuts

Use slugs anywhere a tool accepts slug; Smarts resolves them to chain + address.

• Stablecoins: usdc-eth, usdt-eth, dai-eth, usde-eth, susde-eth, pyusd-eth, usdc-base, usdc-arbitrum, usdc-optimism, usdc-polygon
• Governance tokens: uni-eth, aave-eth, comp-eth, mkr-eth, sky-eth, ldo-eth, arb-arbitrum, op-optimism, aero-base
• Protocol contracts: univ3-factory-eth, univ3-swaprouter-eth, aavev3-pool-eth, aavev3-pool-base, aavev3-pool-arbitrum
• Pools: univ3-usdc-weth-eth, univ3-usdt-weth-eth, univ3-wbtc-weth-eth, univ3-dai-usdc-eth

Ask your AI

• "Is usdc-eth paused right now?"
• "TVL of univ3-usdc-weth-eth?"
• "Who is 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?"
• "Total supply of usdc-arbitrum."

Stack

Rails 8 + Postgres 17 + Hotwire + Tailwind, deployed via Kamal 2 to Hetzner. No TypeScript, no Node services. MCP server via the official mcp Ruby SDK.

License

MIT — see LICENSE.