Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http smartcontract https://smartcontract.run.tools
Open on GitHub

What 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-base slug.
  • Read the current supply, price, and market cap for the usdc-base token.
  • 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.tools

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open