关于 Smarts — Live Docs For Every Smart Contract
Smarts 为 Ethereum、Base、Arbitrum、Optimism 和 Polygon 上经验证的智能合约提供实时文档与检查工具，面向 AI Agent。它通过单一端点提供合约源码、状态、事件、代币和池数据。
主要功能
- 01合约元数据与分类
- 02查询已验证 Solidity 源码
- 03ERC-20 供应量与市场数据
- 04治理及近期事件记录
- 05合约状态与地址检查
- 06Uniswap V3 池数据
适用场景
- 01检查代币合约是否已暂停
- 02查看权限变更和升级记录
- 03读取合约视图函数
- 04检查池流动性和 TVL
MCP 相关
通过 Streamable HTTP 在 https://smarts.md/mcp 提供 MCP 端点。MCP 客户端可调用工具查询合约元数据、源码、状态、事件、代币信息、地址及 Uniswap V3 池。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
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"}}}在 Cursor 中打开{"servers":{"smarts":{"type":"http","url":"https://smarts.md/mcp/sse"}}}在 VS Code 中打开{"mcpServers":{"smarts":{"type":"http","url":"https://smarts.md/mcp/sse"}}}{"mcpServers":{"smarts":{"serverUrl":"https://smarts.md/mcp/sse"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
15| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| slug | string | 否 | 精选的 slug，例如 'uni-eth' 或 'univ3-usdc-weth-eth'。可替代 chain+address。 |
| chain | string | 否 | Chain slug。第 1 层（实时数据）：eth、base、arbitrum、optimism、bnb、polygon、robinhood、arc。第 2 层（仅源代码和 ABI）：linea、unichain、berachain、blast、sonic、mantle、gnosis、celo、fraxtal、taiko、world、abstract。除非提供 `slug`，否则必填。 |
| address | string | 否 | 带 0x 前缀的 EVM 合约地址。除非提供 `slug`，否则必填。 |
详细介绍
smarts.md
每个已验证智能合约的实时文档。将一个 URL 提供给你的 AI Agent，即可询问有关 Ethereum、Base、Arbitrum、Optimism 或 Polygon 上任意合约的问题。
- 网站：https://smarts.md
- MCP 端点：
https://smarts.md/mcp（Streamable HTTP，MCP spec 2025-03-26） - MCP 文档：https://mcp.smarts.md
- 发现：https://smarts.md/.well-known/mcp.json
添加到你的 AI Agent
# Claude Code
claude mcp add --transport http smarts https://smarts.md/mcp
Cursor / Windsurf / Cline / Claude Desktop：请访问 https://mcp.smarts.md 查看各客户端的配置片段。
工具
| 工具 | 说明 |
|---|---|
get_contract_info | 元数据 + 分类 + 适配器标签 |
get_contract_source | 已验证 Solidity 源码的索引、文件内容或 grep 搜索 |
get_erc20_info | 供应量、价格、市值、发行方、管理员控制 |
get_governance_timeline | 特权事件历史：角色变更、升级、暂停、列入黑名单、铸币者配置 |
get_recent_events | 最近解码的合约事件，可按事件名称筛选 |
get_uniswap_v3_pool | 交易对、手续费、价格、流动性、tick、TVL |
inspect_address | EOA 或合约、余额、nonce、反向 ENS |
read_contract_state | 任意带参数的 view/pure 函数 |
精选快捷方式
凡是工具接受 slug 的地方，都可以使用这些别名；Smarts 会将其解析为链 + 地址。
- 稳定币：
usdc-eth、usdt-eth、dai-eth、usde-eth、susde-eth、pyusd-eth、usdc-base、usdc-arbitrum、usdc-optimism、usdc-polygon - 治理代币：
uni-eth、aave-eth、comp-eth、mkr-eth、sky-eth、ldo-eth、arb-arbitrum、op-optimism、aero-base - 协议合约：
univ3-factory-eth、univ3-swaprouter-eth、aavev3-pool-eth、aavev3-pool-base、aavev3-pool-arbitrum - 流动性池：
univ3-usdc-weth-eth、univ3-usdt-weth-eth、univ3-wbtc-weth-eth、univ3-dai-usdc-eth
向你的 AI 提问
- “
usdc-eth现在暂停了吗？” - “
univ3-usdc-weth-eth的 TVL 是多少？” - “
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045是谁？” - “
usdc-arbitrum的总供应量。”
技术栈
Rails 8 + Postgres 17 + Hotwire + Tailwind，通过 Kamal 2 部署到 Hetzner。没有 TypeScript，也没有 Node 服务。MCP 服务使用官方 mcp Ruby SDK。
许可证
MIT — 参见 LICENSE。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。