Model Context Protocol
Point your AI at smarts.md
One endpoint. Every verified smart contract. Live on-chain data your agent can query — no API keys, no scraping.
https://smarts.md/mcp
Quick install
claude mcp add --transport http smarts https://smarts.md/mcp{ "mcpServers": { "smarts": { "url": "https://smarts.md/mcp" } } }[mcp_servers.smarts]
url = "https://smarts.md/mcp"{ "mcpServers": { "smarts": { "command": "npx", "args": ["-y", "mcp-remote", "https://smarts.md/mcp"] } } }Uses mcp-remote to bridge Streamable HTTP → stdio.
https://smarts.md/mcpCheck the client's MCP docs for exact config syntax — the URL is what matters.
Ask your AI
“Is USDC paused right now?”
→ get_erc20_info
“What's the TVL of the Uniswap V3 USDC/WETH 0.05% pool?”
→ get_uniswap_v3_pool
“Who is 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?”
→ inspect_address
“Get the total supply of USDT on Arbitrum.”
→ get_erc20_info
“Who can blacklist my USDC balance?”
→ get_erc20_info
“Show me the current admin risk profile for USDC.”
→ get_admin_risk
“Show me where USDC's blacklisting logic lives in source.”
→ get_contract_source
“Show me the last 10 swaps on the USDC/WETH 0.05% pool.”
→ get_recent_events
“How has admin power on USDC evolved? Show me every role change and pause.”
→ get_governance_timeline
“Who can pause or upgrade Polymarket's CTF Exchange V2?”
→ get_governance_timeline
“What does Polymarket think about this market by slug?”
→ get_polymarket_market
“Audit how this Polymarket market resolved on-chain.”
→ get_polymarket_resolution
“Call balanceOf(0xabc…) on USDC.”
→ read_contract_state
On-chain native
Smarts does not stop at API metadata. Your AI can verify contract state, decoded events, governance changes, and Polymarket resolution payouts directly from chain data, then compare that evidence with off-chain market status when useful.
Tools
get_contract_info
Metadata about a verified contract: name, classification, adapter, function counts.
get_contract_source
Fetch the verified Solidity source: file index, single-file content, or substring grep across files.
get_admin_risk
Current admin / risk profile for a verified contract: detected controls, current values, governance summary, and warnings.
get_erc20_info
Live token state: formatted supply, price, market cap, issuer, admin controls (paused/owner/minter/…).
get_governance_timeline
Privileged-event history for a contract, including Polymarket exchange/CTF/UMA slugs: role changes, proxy upgrades, pauses, blacklisting, minter config — decoded, categorized, summarized.
get_polymarket_market
Polymarket market state by slug or condition ID: outcomes, prices when present, resolution payouts, and CTF position IDs.
get_polymarket_position
Wallet balances for explicit Polymarket markets by condition ID or slug, including redeemable resolved outcomes.
get_polymarket_resolution
Resolution audit for a Polymarket market: CTF payout vector from chain, Gamma closed/open status, outcome IDs, and consistency flags.
get_recent_events
Most recent events emitted by a contract, decoded against its ABI. Filter by event name; unknown topics return raw.
get_uniswap_v3_pool
Live pool state: token pair, fee, both-direction price, liquidity, tick, TVL.
inspect_address
Classifies any address as EOA / contract / EIP-7702 wallet, plus balance, nonce, and reverse ENS.
list_article_drafts
Authenticated publishing workflow: list multilingual article drafts under docs/drafts.
publish_article
Authenticated publishing workflow: validate and publish a multilingual draft into article pages.
validate_article_draft
Authenticated publishing workflow: validate one multilingual article draft without saving.
read_contract_state
Read any view/pure function by name, with positional args. Returns decoded output.
Curated shortcuts
Use slugs anywhere a tool accepts slug. They resolve to curated blue-chip contracts without copying chain IDs or hex addresses.
usdc-eth
Ethereum USDC — stablecoin admin controls and governance timeline.
usdt-arbitrum
Arbitrum USDT — multi-chain stablecoin lookup.
univ3-usdc-weth-eth
Deep Uniswap V3 USDC/WETH pool on Ethereum.
aavev3-pool-base
Aave V3 Pool proxy on Base.
univ3-factory-eth
Canonical Uniswap V3 factory on Ethereum.
polymarket-ctf-exchange-v2-polygon
Polymarket binary market exchange — admin and pause surface.
polymarket-neg-risk-exchange-v2-polygon
Polymarket neg-risk exchange — multi-outcome admin surface.
polymarket-uma-adapter-v3-polygon
Polymarket UMA adapter — resolution and dispute governance.