relay_get_chainsLABSCO SUMMARY
Prices, quotes and status on cross-chain moves, with one call that acts.
Most of the surface answers questions before anything moves: which chains, which tokens, what it costs right now, what the quote is. relay_swap_multi_input is the one that acts, pulling balances scattered across chains into a single destination. Since the API takes no key, the whole setup cost is a build step.
What it is
A server over the Relay Protocol REST API: it quotes a bridge or a swap, aggregates tokens from several chains into one destination, and follows a request until it settles.
What you get
- The chains Relay can bridge between, listed
- Supported currencies with filtering, across a catalogue of 1000+ tokens
- A current token price on any supported chain
- A quote for a bridge or swap before you commit to it
- A multi-input swap, aggregating tokens from several chains into a single destination
- Execution status for a request in flight
- Your requests, listed
- Transactions indexed, and a single transaction looked up
Requirements
No API key — the Relay public API is free. Build with pnpm and run over stdio for a local client, or start the SSE server and point a hosted client at its URL.
Setup effort
Build from source — git clone https://github.com/warengonzaga/relay-protocol-mcp-server
USE CASES
01
Checking what a bridge would cost before committing
Take the quote and the current token price together, so the fee is read against a live number.
02
Finding out whether a chain pair is even supported
List the chains, then filter the currency catalogue to the token you actually hold.
03
Consolidating small balances spread across several chains
Aggregate the inputs into one destination in a single swap instead of bridging each chain separately.
04
Watching a bridge that has not landed yet
Poll the execution status for the request, and list your requests when you have lost track of the id.
05
Looking up what happened in a past transaction
Search the transaction index, then read the single transaction that matches.
9 tools
Listed in project docs. Your client may show a different list.
relay_get_token_pricerelay_get_currenciesrelay_get_quoterelay_swap_multi_inputrelay_get_execution_statusrelay_get_requestsrelay_transactions_indexrelay_transactions_singleBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- Node.js >= 20.0.0
- pnpm package manager
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/warengonzaga/relay-protocol-mcp-server
cd relay-protocol-mcp-server
pnpm install && pnpm buildMCP Clients
Claude Desktop — stdio
CLAUDE DESKTOP — STDIO · JSON
{
"mcpServers": {
"Relay Protocol": {
"command": "node",
"args": [
"<YOUR_PATH_TO_RELAY_PROTOCOL_MCP_SERVER>/dist/index.js"
]
}
}
}
