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