UCAI

Universal Contract AI Interface

The ABI-to-MCP Server Generator

    ██╗   ██╗ ██████╗ █████╗ ██╗

██║ ██║██╔════╝██╔══██╗██║ ██║ ██║██║ ███████║██║ ██║ ██║██║ ██╔══██║██║ ╚██████╔╝╚██████╗██║ ██║██║ ╚═════╝ ╚═════╝╚═╝ ╚═╝╚═╝

Any contract. One command. Claude speaks it.

🙇♀️ Universal Contract AI Interface ☑️ UCAI in Anthropic MCP Registry | 🌐 Try the Web Builder → | 📖 Documentation | 🛡️ Security Scanner

---

🌐 Try It Live — No Install Required

[mcp.ucai.tech](https://mcp.ucai.tech) — Generate MCP servers directly in your browser.

+--------------------------------------------------------------------------+

| | | MCP BUILDER [Connect Wallet] | | | | +---------------------------+--------------------------------------+ | | | Pro Templates | Custom Contract | | | +---------------------------+--------------------------------------+ | | | | Security Scanner: Score 87/100 - Low Risk | | |-- Contract verified on Etherscan | | |-- Uses OpenZeppelin (audited) | | |-- Owner can pause transfers (warning) | | +-- Mint function detected (warning) | | | | What This Contract Does: | | "ERC-20 token with standard transfer, approve, and allowance | | functions." | | | | [Download Server] [Share Link] [Copy Config] | | | +--------------------------------------------------------------------------+

Features:

• 🛡️ Security Scanner — Detects rug pulls, honeypots, and 50+ risks before you connect
• 📖 Contract Whisperer — Explains contracts in plain English
• ⚡ Pro Templates — Pre-built bundles for Flash Loans, Arbitrage, Yield Aggregators
• 🌙 Dark/Light Mode — Easy on the eyes
• 📥 ZIP Download — Complete server with server.py, requirements.txt, README.md
• 🔗 Share Links — Send ?address=0x...&network=ethereum to anyone

---

Overview

┌────────────────────────────────────────────────────────────────────────────┐

│ │ │ 1. FIND 2. GENERATE 3. DONE │ │ │ │ ┌─────────────────┐ ┌─────────────────┐ ┌───────────────┐ │ │ │ Etherscan │ │ │ │ │ │ │ │ ┌─────────┐ │ │ $ abi-to-mcp │ │ Claude │ │ │ │ │ Contract│ │ ────▶ │ generate │ ──▶ │ Tools │ │ │ │ │ ABI │ │ │ 0x7a25... │ │ │ │ │ │ └─────────┘ │ │ │ │ "Swap 1 ETH" │ │ │ └─────────────────┘ └─────────────────┘ └───────────────┘ │ │ │ │ Any contract One command AI speaks it │ │ │ └────────────────────────────────────────────────────────────────────────────┘

Found a contract on Etherscan? One command. Claude can now use it.

pip install abi-to-mcp

Uniswap — Claude can swap tokens

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server

ETH 2.0 Beacon Deposit — Claude can explore staking

abi-to-mcp generate 0x00000000219ab540356cBB839Cbe05303d7705Fa -o ~/eth-staking-server

Any verified contract works

abi-to-mcp generate

That's it. Every function, every event, every query — now a Claude tool.

---

Quick Start

1. Generate a server

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server

cd ~/uniswap-server && pip install -r requirements.txt

2. Connect to Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{

"mcpServers": { "uniswap": { "command": "python", "args": ["/Users/YOU/uniswap-server/server.py"], "env": { "RPC_URL": "https://eth.llamarpc.com" } } } }

3. Ask Claude anything

• *"What's the best route to swap 1 ETH for USDC?"*
• *"Get the reserves for the ETH/DAI pool"*
• *"Show me recent swaps on Uniswap"*

Claude now speaks DeFi.

---

Example

┌────────────────────────────────────────────────────────────────────────────┐

│ YOU │ ├────────────────────────────────────────────────────────────────────────────┤ │ "What's the best route to swap 1 ETH for USDC on Uniswap?" │ └────────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────────┐ │ CLAUDE │ ├────────────────────────────────────────────────────────────────────────────┤ │ I'll check the Uniswap router for the best path... │ │ │ │ Called: getAmountsOut(1 ETH, [WETH, USDC]) │ │ │ │ Best route: ETH -> WETH -> USDC │ │ You would receive: 3,847.23 USDC │ │ Price impact: 0.02% │ └────────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────────┐ │ YOU │ ├────────────────────────────────────────────────────────────────────────────┤ │ "Do it. Swap 1 ETH for USDC." │ └────────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────────┐ │ CLAUDE │ ├────────────────────────────────────────────────────────────────────────────┤ │ Simulating transaction first... │ │ │ │ Simulation successful │ │ Gas estimate: 152,847 (~$3.42) │ │ Expected output: 3,847.23 USDC │ │ │ │ Ready to execute. Confirm? [Yes/No] │ └────────────────────────────────────────────────────────────────────────────┘

---

The UCAI Standard

UCAI (Universal Contract AI Interface) is a standard for how AI agents interact with smart contracts.

╔═══════════════════════════════════════════════════════════════════════════════╗

║ ║ ║ ┌─────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────┐ ║ ║ │ │ │ │ │ │ │ │ ║ ║ │ Claude │─────>│ abi-to-mcp │─────>│ MCP Server │─────>│ Chain │ ║ ║ │ │ │ generate │ │ (your tools) │ │ │ ║ ║ └─────────┘ └──────────────┘ └──────────────┘ └──────────┘ ║ ║ │ │ │ ║ ║ │ "swap 1 ETH" │ call swap() │ ║ ║ └────────────────────────────────────────┴─────────────────────┘ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════════╝

UCAI defines

• 📋 Tool schemas — How contract functions become AI-callable tools
• 🔄 Type mappings — Solidity → JSON Schema → Python
• 🔒 Safety patterns — Simulation-first for all state changes
• 📡 Event queries — Historical data access patterns

Why UCAI

• 🔁 Repeatable — Same pattern works for ERC20, ERC721, DeFi, DAOs, Solana, anything
• 🔒 Safe by default — All write operations simulate first
• 🌐 Universal — Works on any chain, with any AI agent
• 🤖 AI-native — Designed specifically for LLM tool-calling

Every contract becomes AI-accessible through the same interface. No custom code per contract.

*This package (abi-to-mcp) is the reference implementation of UCAI for MCP.*

---

Why UCAI?

The Problem: You want AI to interact with smart contracts. But:

• Writing MCP server boilerplate is tedious
• Mapping Solidity types to JSON Schema is error-prone
• Every contract needs the same patterns repeated
• Safety (simulation, gas limits) is easy to forget

The Solution: One command generates a production-ready MCP server from any ABI.

---

Use Cases

• AI Agent Builders — Give your agent DeFi superpowers (swap, lend, vote)
• Wallet Developers — Let Claude explain and execute transactions
• DAO Tooling — AI-powered proposal creation, voting, treasury management
• DeFi Dashboards — Natural language queries for on-chain data
• Vibecoders — Ship faster with AI-generated blockchain tools

---

Real Examples

🦄 Uniswap: Swap tokens with natural language

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server