Skip to content

UCAI

The ABI-to-MCP Server Generator. Generate AI-ready interfaces for any smart contract in seconds.

UCAI converts Ethereum smart contract ABIs into Model Context Protocol (MCP) servers, enabling AI assistants like Claude to interact with DeFi protocols, NFTs, tokens, and any on-chain contract.

  • Zero to MCP in 30 Seconds

    One command generates a complete, production-ready server:

    abi-to-mcp generate 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 -n mainnet

    Quickstart

  • Safety First

    Write operations simulate by default. You explicitly opt-in to real transactions.

    Safety features

  • 10+ Networks

    Ethereum, Polygon, Arbitrum, Optimism, Base, BSC, Avalanche, and more.

    Supported networks

  • Python API

    Programmatic access for custom workflows and integrations.

    API reference

🌐 Try It Online

Don't want to install anything? Use the Web Builder to generate MCP servers directly in your browser:

  • Security Scanner

    Detect rug pulls, honeypots, and 50+ risks before connecting your AI agent.

    Learn more

  • Contract Whisperer

    Get plain English explanations of what any contract does.

    Web Builder guide

  • Pro Templates

    Pre-built bundles for Flash Loans, Arbitrage, Yield Farming, and more.

    Web Builder guide

What is MCP?

The Model Context Protocol (MCP) is a standard for connecting AI assistants to external tools and data sources. When you generate an MCP server from a smart contract ABI, Claude can:

  • Query token balances, allowances, and contract state
  • Inspect NFT metadata and ownership
  • Simulate transactions before execution
  • Execute transfers, swaps, and other operations (with your approval)

Quick Example

Here's what it looks like to use a generated MCP server with Claude:

You: What's the USDC balance of vitalik.eth?

Claude: I'll check the USDC balance for vitalik.eth.

Using balance_of tool with address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045...

The balance is 2,547.32 USDC.

Installation

pip install abi-to-mcp

pipx install abi-to-mcp

git clone https://github.com/nirholas/UCAI.git
cd UCAI
pip install -e .

Supported Contract Types

abi-to-mcp works with any EVM smart contract, with special support for common standards:

Standard Auto-Detection Features
ERC-20 ✅ Yes Token transfers, approvals, balance queries
ERC-721 ✅ Yes NFT ownership, metadata, safe transfers
ERC-1155 ✅ Yes Multi-token operations, batch transfers
ERC-4626 ✅ Yes Vault deposits, withdrawals, share calculations
Custom ✅ Yes All functions and events exposed as tools

How It Works

graph LR
    A[Smart Contract ABI] --> B[abi-to-mcp]
    B --> C[MCP Server]
    C --> D[Claude Desktop]
    D --> E[Blockchain]

    style A fill:#627EEA,color:#fff
    style B fill:#9C27B0,color:#fff
    style C fill:#4CAF50,color:#fff
    style D fill:#FF9800,color:#fff
    style E fill:#627EEA,color:#fff
  1. Fetch - Retrieve the ABI from Etherscan, Sourcify, or a local file
  2. Parse - Analyze functions, events, and types
  3. Map - Convert Solidity types to JSON Schema and Python types
  4. Generate - Create a complete MCP server with all tools and resources
  5. Run - Start the server and connect it to Claude Desktop

Next Steps

Community