Relay MCP Server

A Model Context Protocol server for Relay Protocol — cross-chain bridge and swap tools for AI agents.

Tools

Tool	Description
get_supported_chains	List supported blockchain networks
get_supported_tokens	Search for tokens across chains
get_bridge_quote	Quote for bridging same token across chains
get_swap_quote	Quote for swapping between different tokens
estimate_fees	Fee breakdown for a bridge or swap
get_transaction_status	Check status of a relay transaction
get_transaction_history	Past transactions for a wallet
get_relay_app_url	Deep link to the Relay web app with pre-filled parameters

Usage

Claude Desktop / Claude Code

Add to your claude_desktop_config.json or .claude.json:

{
  "mcpServers": {
    "relay": {
      "command": "npx",
      "args": ["-y", "@relayprotocol/relay-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "relay": {
      "command": "npx",
      "args": ["-y", "@relayprotocol/relay-mcp"]
    }
  }
}

Run from source

npm install
npm run build
npm start

Environment variables

Variable	Default	Description
RELAY_API_URL	https://api.relay.link	Relay API base URL
RELAY_API_KEY	—	Optional API key for higher rate limits

Architecture

• Transport: Stdio (MCP spec)
• Runtime: Node.js >=20
• API: Direct HTTP calls to api.relay.link (no SDK dependency)
• Read-only: Returns quotes, fees, and status. Does not sign or broadcast transactions.

Agent flow example

User: "Bridge 0.1 ETH from Ethereum to Base"

1. Agent calls get_supported_chains → resolves Ethereum=1, Base=8453
2. Agent calls get_bridge_quote → gets quote with fees and ETA
3. Agent shows user the quote and a link to execute on relay.link

License

MIT