Smarts — Live on-chain docs for every smart contract

# 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. Each page pulls metadata from Etherscan, reads live state via Multicall3, and enriches with an AI-generated explanation. Smarts is an AI-native documentation platform for smart contracts. Unlike static docs, every page is regenerated from on-chain state, so balances, prices, TVL, pause flags, and admin roles are always current. ## How to use from an AI agent The fastest path: connect our MCP server once, then query any contract by chain+address or by a curated slug. - [MCP endpoint](https://smarts.md/mcp): Streamable HTTP transport (MCP spec 2025-03-26), 5 tools, no auth - [MCP setup docs](https://mcp.smarts.md/): per-client config for Claude Code, Claude Desktop, Cursor, Windsurf, Cline - [Discovery manifest](https://smarts.md/.well-known/mcp.json): forward-looking JSON describing endpoint, transport, and tools One-line Claude Code setup: ``` claude mcp add --transport http smarts https://smarts.md/mcp ``` ## URL patterns - `https://smarts.md/{chain}/{address}` — canonical, e.g. `/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48` - `https://smarts.md/{slug}` — friendly form for curated contracts, e.g. `/usdc-eth`, `/usdc-base`, `/univ3-usdc-weth-eth` Supported chains (slug suffix in parentheses): Ethereum (`-eth`), Base (`-base`), Arbitrum (`-arbitrum`), Optimism (`-optimism`), Polygon (`-polygon`). ## MCP tools - `get_contract_info` — verified metadata, protocol classification, adapter tag, function counts - `get_erc20_info` — live supply, price, market cap, issuer, admin controls (paused, owner, minter, blacklist) - `get_uniswap_v3_pool` — token pair, fee tier, both-direction price, liquidity, tick, TVL - `inspect_address` — classify EOA vs contract vs EIP-7702 wallet, plus balance, nonce, reverse ENS - `read_contract_state` — call any view/pure function by name with positio

{"openapi":"3.1.0","info":{"title":"Smarts API","version":"1.0.0","description":"Live docs for every verified smart contract. Query on-chain state, ERC-20 tokens, Uniswap V3 pools, admin risk, governance events, Polymarket markets, and more across Ethereum, Base, Arbitrum, Optimism, BNB, and Polygon."},"servers":[{"url":"https://smarts.md"}],"paths":{"/api/v1/get_contract_info":{"get":{"operationId":"get_contract_info","summary":"Get metadata about a verified smart contract: name, compiler, clas