# smarts.md

The smarts.md MCP server lets an AI agent inspect verified contracts, ERC-20 tokens, Uniswap V3 pools, and arbitrary EVM addresses.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2929 installs
- Author: defi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/defi-io/smartcontract
- Updated: 2026-04-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/smartsmd

## What it 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`.

## Requirements
- Remote server: `https://smartcontract.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http smartcontract https://smartcontract.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add smartsmd --url https://smartcontract.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "smartsmd": {
            "url": "https://smartcontract.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "smartsmd": {
            "type": "http",
            "url": "https://smartcontract.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http smartsmd https://smartcontract.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [leandrogavidia-vechain-mcp-server](https://affpapa.org/en/nevibecode/mcp/leandrogavidia-vechain-mcp-server.md) — MCP server · ★ 5 repo stars
- [clanker](https://affpapa.org/en/nevibecode/skills/clanker.md) — skill · 230 installs
- [token-minter](https://affpapa.org/en/nevibecode/skills/token-minter.md) — skill · 158 installs
- [ethskills](https://affpapa.org/en/nevibecode/skills/ethskills.md) — skill · 2500 installs
- [addresses](https://affpapa.org/en/nevibecode/skills/addresses.md) — skill · 254 installs
- [smart-contract-specialist](https://affpapa.org/en/nevibecode/agents/smart-contract-specialist.md) — subagent · 708 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
