MCP Server

The Yield.xyz MCP Server exposes 7 structured tools that Claude uses to interact with Yield.xyz directly within a conversation.

Endpoint: https://mcp.yield.xyz/mcp

Verify the server is live:

GET https://mcp.yield.xyz/health

{ "status": "ok", "service": "yield-mcp-server" }

A 200 OK confirms the server is healthy and ready to accept tool calls.

No API key required for testing.

What is MCP?

The Model Context Protocol is an open standard from Anthropic that lets AI models connect securely to external APIs and tools through a standardised client-server interface.

Without MCP, Claude has no live access to on-chain yield data. With it, yields_get_all, actions_enter, and the other 5 tools become callable directly in conversation — with real APYs, live TVL, and chain-correct unsigned transactions returned in response.

Quick Start

Three connection methods — choose based on your setup.

Method 1: Claude Connector (no local setup)

Requires Claude Pro, Max, or Enterprise.

1. Go to Claude → Settings → Connectors
2. Click Add connector → Custom MCP server
3. Enter:
   • Name: Yield.xyz Agent
   • URL: https://mcp.yield.xyz/mcp
4. Click Connect

The 7 Yield tools will appear automatically in your conversations.

Enterprise / Team: A workspace admin must first enable custom connectors in Organisation Settings → Connectors before members can add external MCP servers.

Verify it's working:

Find me the top USDC lending yields on Base sorted by APY.

Claude will call yields_get and return live yield data. If it doesn't, check the connector is toggled on via "+" → Connectors in the conversation.

Method 2: Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "yield_xyz_agent": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.yield.xyz/mcp"]
    }
  }
}

Save and restart Claude Desktop.

Verify:

Find me the top USDC lending yields on Base sorted by APY.

Method 3: Claude Code

Local scope — private to you, stored in ~/.claude.json:

claude mcp add --transport http yield_xyz_agent https://mcp.yield.xyz/mcp

Project scope — shared with your team via version control:

claude mcp add --transport http yield_xyz_agent --scope project https://mcp.yield.xyz/mcp

This creates .mcp.json at your project root:

{
  "mcpServers": {
    "yield_xyz_agent": {
      "type": "http",
      "url": "https://mcp.yield.xyz/mcp"
    }
  }
}

Security: Claude Code prompts for approval before using project-scoped servers from .mcp.json. To reset approval choices: claude mcp reset-project-choices

What's Next