Ucai

🚀 Universal Contract AI Interface

The ABI-to-MCP Server Generator enables AI agents to interact with smart contracts effortlessly, providing a standardized and efficient way to bridge the gap between AI and blockchain.

🚀 Quick Start

Generate a Server

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server
cd ~/uniswap-server && pip install -r requirements.txt

Connect to Claude Desktop

Add the following 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"
      }
    }
  }
}

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 can now interact with DeFi protocols effectively.

✨ 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.

📦 Installation

pip install abi-to-mcp

💻 Usage Examples

Basic Usage

# 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>

Advanced Usage

# Generate a server with custom options
abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server --read-only --no-events

📚 Documentation

• Overview: The abi-to-mcp tool generates MCP servers from contract ABIs, allowing AI agents like Claude to interact with smart contracts.
• UCAI Standard: Defines how AI agents interact with smart contracts, including tool schemas, type mappings, safety patterns, and event queries.
• CLI Reference:
  • abi-to-mcp generate <source> [options]: Generate an MCP server from an ABI.
  • abi-to-mcp inspect <source>: Preview what would be generated without creating files.
  • abi-to-mcp validate <source>: Validate an ABI without generating.

🔧 Technical Details

• Type Mapping: Maps Solidity types to JSON Schema and Python types. | Solidity Type | JSON Schema | Python Type | |---------------|-------------|-------------| | address | string with pattern | str | | uint256 | string (for precision) | str | | uint8-uint32 | integer with bounds | int | | bool | boolean | bool | | string | string | str | | bytes | string with pattern | str | | bytes32 | string with pattern | str | | tuple | object | Dict | | T[] | array | List | | T[N] | array with bounds | List |

• Environment Variables: | Variable | Description | Required | |----------|-------------|----------| | RPC_URL | Web3 RPC endpoint | Yes | | CONTRACT_ADDRESS | Override contract address | No | | PRIVATE_KEY | For write operations | For writes | | ETHERSCAN_API_KEY | For fetching from Etherscan | For Etherscan |

• Supported Networks: | Network | ID | Chain ID | |---------|------|----------| | mainnet | Ethereum | 1 | | sepolia | Sepolia Testnet | 11155111 | | polygon | Polygon | 137 | | arbitrum | Arbitrum One | 42161 | | optimism | Optimism | 10 | | base | Base | 8453 | | bsc | BNB Chain | 56 | | avalanche | Avalanche C-Chain | 43114 |

📄 License

This project is licensed under the MIT License. See LICENSE for details.

🌐 Live HTTP Deployment

UCAI — ABI to MCP is deployed and accessible over HTTP via MCP Streamable HTTP transport — no local installation required.

Endpoint

https://modelcontextprotocol.name/mcp/ucai

Connect from any MCP Client

Add to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.):

{
  "mcpServers": {
    "ucai": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/ucai"
    }
  }
}

Available Tools (5)

Example Requests

Look up a smart contract:

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup_contract","arguments":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}}'

Token metadata by contract:

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_token_by_contract","arguments":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}}}'

Get crypto prices:

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ids":"usd-coin","vs_currencies":"usd"}}}'

List All Tools

curl -X POST https://modelcontextprotocol.name/mcp/ucai \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Also Available On

• SperaxOS — Browse and install from the MCP marketplace
• All 27 MCP servers — See the full catalog at modelcontextprotocol.name

Powered by modelcontextprotocol.name — the open MCP HTTP gateway