smarts.md — Claude Code MCP server: setup
The smarts.md MCP server lets an AI agent inspect verified contracts, ERC-20 tokens, Uniswap V3 pools, and arbitrary EVM addresses.
no license 2,929 installs updated 2026-04-27
claude mcp add --transport http smartcontract https://smartcontract.run.toolsWhat smarts.md does
smarts.md exposes five tools for live EVM data. get_contract_info returns metadata for a verified contract, including its name, compiler, classification, adapters, function count, and event count. get_erc20_info reads token supply, price, market cap, issuer, and exposed admin controls for centralized stablecoins. get_uniswap_v3_pool reports the pair, fee tier, prices, active liquidity, tick, and USD TVL.
The address tool identifies an EOA, an unverified contract, or an EIP-7702 delegated wallet. It also returns native balance, nonce, and reverse ENS on Ethereum. read_contract_state calls a view or pure function and returns decoded output; chain reads use a 60s cache. The MCP connection depends on https://smartcontract.run.tools.
What it helps with
- inspect metadata for a verified contract
- check live ERC-20 token state
- read the current state of a Uniswap V3 pool
- classify an EVM address before calling contract tools
- fetch the decoded result of a view function
Example prompts for the agent
- Get contract metadata for the
usdc-baseslug. - Read the current supply, price, and market cap for the
usdc-basetoken. - Inspect the EVM address I provide and report its class, balance, and nonce.
How to install smarts.md
Platform CLI: remote server
claude mcp add --transport http smartcontract https://smartcontract.run.toolsPlatform CLI: remote server
codex mcp add smartsmd --url https://smartcontract.run.toolsConfig file
{
"mcpServers": {
"smartsmd": {
"url": "https://smartcontract.run.tools"
}
}
}Config file
{
"servers": {
"smartsmd": {
"type": "http",
"url": "https://smartcontract.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http smartsmd https://smartcontract.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about smarts.md
How do I install smarts.md in Claude Code?
Run these commands in order: claude mcp add --transport http smartcontract https://smartcontract.run.tools, then claude mcp add --transport http smartsmd https://smartcontract.run.tools.
What does smarts.md do?
It gives an AI agent MCP tools for contract metadata, ERC-20 state, Uniswap V3 pool data, EVM address inspection, and view or pure function calls.
Can smarts.md inspect an unindexed address?
Yes. inspect_address works with unindexed EVM addresses and helps determine whether a contract-specific lookup is appropriate.