Quick Start

Get your AI agent interacting with blockchains in under 5 minutes.

1. Install the MCP Server

npm install @y0exchange/mcp

2. Configure for Claude Desktop

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

{
  "mcpServers": {
    "y0": {
      "command": "npx",
      "args": ["@y0exchange/mcp"],
      "env": {
        "ZEROX_API_KEY": "your-0x-api-key",
        "COINGECKO_API_KEY": "your-coingecko-key",
        "ETHERSCAN_API_KEY": "your-etherscan-key"
      }
    }
  }
}

3. Start Using

Once configured, you can ask your AI agent things like:

“What is the ETH balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?”
“Get me a swap quote for 100 USDC to ETH on Ethereum”
“What’s the current gas price on Arbitrum?”
“Show me the transaction history for this wallet on Base”

Environment Variables

Required for Read Tools

Variable	Description	Required
`ZEROX_API_KEY`	0x API key (for quotes)	For quotes
`COINGECKO_API_KEY`	CoinGecko API key (for prices)	For prices
`ETHERSCAN_API_KEY`	Etherscan API key (for history)	For history
`BSCSCAN_API_KEY`	BSCScan API key	For BSC history

Required for Write Tools

Variable	Description	Required
`Y0_API_KEY`	y0 API key (all tiers)	For write tools
`Y0_SIGNING_SERVICE_URL`	Signing service URL	For write tools

Optional (Affiliate Revenue)

Variable	Description
`ZEROX_AFFILIATE_ADDRESS`	Your wallet for 0x affiliate tracking
`ONEINCH_REFERRER_ADDRESS`	Your wallet for 1inch referral fees
`LIFI_INTEGRATOR`	Your LI.FI integrator ID (default: `y0exchange`)

Next Steps

MCP Tools Reference — See all 10 tools with parameters
Architecture — Understand the signing flow
Claude Desktop Guide — Detailed setup for Claude
LangChain Guide — Using y0 with LangChain

Introduction Architecture