Quick Start

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

1. Get Your API Key

Connect your wallet at app.y0.exchange
Go to API Keys → Create API Key
Copy your key (starts with y0_)

2. Connect Your AI App

Add connector (recommended — no install, no coding)

Works on Claude Desktop, claude.ai, Claude Mobile, and ChatGPT:

Open your AI app → Settings → Connectors → Add custom connector
Name: y0
URL: https://mcp.y0.exchange/mcp?key=YOUR_API_KEY
Save — done!

Developer IDEs (Cursor, Windsurf)

Add to your MCP config (e.g. .cursor/mcp.json):

{
  "mcpServers": {
    "y0": {
      "command": "npx",
      "args": ["-y", "@y0exchange/mcp"],
      "env": {
        "Y0_API_KEY": "y0_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http y0 https://mcp.y0.exchange/mcp?key=YOUR_API_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

If you’re using the connector approach, no environment variables are needed — everything is handled via the URL.

If you’re using the local MCP server (developer IDEs), only Y0_API_KEY is required for write tools (swaps, sends). All other keys are optional. See the Developer IDEs guide for the full configuration reference.

Next Steps

MCP Tools Reference — See all 8 tools with parameters
Architecture — Understand the signing flow
Claude Guide — Detailed setup for all Claude platforms
ChatGPT Guide — Connect y0 to ChatGPT
Developer IDEs — Cursor, Windsurf, Claude Code setup
LangChain Guide — Using y0 with LangChain / Python

Introduction Architecture