UCAI
Universal Contract AI Interface (UCAI) π ABI to MCP | The open standard for connecting AI agents to blockchain. MCP server generator for smart contracts. Claude + Uniswap, Aave, ERC20, NFTs, DeFi. Python CLI, Web3 integration, transaction simulation. Polygon, Arbitrum, Base, Ethereum EVM chains. Claude, GPT, LLM tooling, Solidity, OpenAI.
Install / Use
/learn @nirholas/UCAIQuality Score
Category
Development & EngineeringSupported Platforms
README
Universal Contract AI Interface
The ABI-to-MCP Server Generator
βββ βββ βββββββ ββββββ βββ
βββ ββββββββββββββββββββββ
βββ ββββββ βββββββββββ
βββ ββββββ βββββββββββ
ββββββββββββββββββββ ββββββ
βββββββ ββββββββββ ββββββ
Any contract. One command. Claude speaks it.
<!-- mcp-name: io.github.nirholas/abi-to-mcp -->
<p align="center">
<a href="https://registry.modelcontextprotocol.io/?q=nirholas"><strong>βοΈ UCAI in Anthropic MCP Registry</strong></a>
|
<a href="https://mcp.ucai.tech"><strong>π Try the Web Builder β</strong></a>
|
<a href="https://docs.ucai.tech"><strong>π Documentation</strong></a>
|
<a href="#-security-scanner"><strong>π‘οΈ Security Scanner</strong></a>
</p>
π Try It Live β No Install Required
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=ethereumto 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 <ANY_CONTRACT_ADDRESS>
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 defin
