Smarts — Live Docs For Every Smart Contract
RemoteAbout Smarts — Live Docs For Every Smart Contract
Smarts provides live documentation and inspection tools for verified smart contracts on Ethereum, Base, Arbitrum, Optimism, and Polygon. It is intended for AI agents and offers contract source, state, event, token, and pool data through a single endpoint.
Key features
- 01Contract metadata and classification
- 02Verified Solidity source lookup
- 03ERC-20 supply and market data
- 04Governance and recent event history
- 05Contract state and address inspection
- 06Uniswap V3 pool data
Use cases
- 01Check whether a token contract is paused
- 02Review privileged changes and upgrades
- 03Read a contract view function
- 04Inspect pool liquidity and TVL
MCP support
Provides an MCP endpoint at https://smarts.md/mcp using Streamable HTTP. MCP clients can call tools for contract metadata, source, state, events, token information, address inspection, and Uniswap V3 pools.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://smarts.md/mcp/sseclaude mcp add --transport http smarts https://smarts.md/mcp/sse{"mcpServers":{"smarts":{"type":"http","url":"https://smarts.md/mcp/sse"}}}Open in Cursor{"servers":{"smarts":{"type":"http","url":"https://smarts.md/mcp/sse"}}}Open in VS Code{"mcpServers":{"smarts":{"type":"http","url":"https://smarts.md/mcp/sse"}}}{"mcpServers":{"smarts":{"serverUrl":"https://smarts.md/mcp/sse"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
15| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | No | Curated slug like 'uni-eth' or 'univ3-usdc-weth-eth'. Alternative to chain+address. |
| chain | string | No | Chain slug. Tier 1 (live data): eth, base, arbitrum, optimism, bnb, polygon, robinhood, arc. Tier 2 (source + ABI only): linea, unichain, berachain, blast, sonic, mantle, gnosis, celo, fraxtal, taiko, world, abstract. Required unless `slug` is given. |
| address | string | No | The 0x-prefixed EVM contract address. Required unless `slug` is given. |
Details
From the project READMEsmarts.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-ethpaused 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.