agentleFS
defi-iodefi-io/smarts/public/llms.txt

smarts

llms.txt1 starsChanged 6 months agoMITView on GitHub

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. The fastest path: connect our MCP…

The file

We split this llms.txt into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only verified contracts (sourced from Etherscan V2).

    line 53
  2. Distinctive:

    Only EVM chains listed above.

    line 54

≈ “Common” is an estimate: at least 1 in 5 of the 3,727 llms.txt files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
llms.txt
# 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 positional args; returns decoded output

## Featured contracts (stable references)

- [USDC on Ethereum](https://smarts.md/usdc-eth)
- [USDT on Ethereum](https://smarts.md/usdt-eth)
- [DAI on Ethereum](https://smarts.md/dai-eth)
- [WETH](https://smarts.md/weth-eth)
- [WBTC](https://smarts.md/wbtc-eth)
- [UNI governance token](https://smarts.md/uni-eth)
- [LINK](https://smarts.md/link-eth)
- [AAVE](https://smarts.md/aave-eth)
- [Uniswap V3 USDC/WETH 0.05% pool](https://smarts.md/univ3-usdc-weth-eth)
- [USDC on Base](https://smarts.md/usdc-base)
- [USDC on Arbitrum](https://smarts.md/usdc-arbitrum)
- [Wrapped POL on Polygon](https://smarts.md/wpol-polygon)

## Scope and limits

- Only verified contracts (sourced from Etherscan V2); unverified bytecode is not supported.
- Only EVM chains listed above. No Solana, Bitcoin, or Move.
- Proxy contracts (EIP-1967, transparent, UUPS) are resolved to their implementation.
- Live on-chain reads are cached for 60 seconds. ABI and source code are cached for 30 days.

## Project

- [Homepage](https://smarts.md/)
- [Source on GitHub](https://github.com/defi-io/smarts)
- [README](https://github.com/defi-io/smarts#readme)
- License: MIT

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.