Skip to main content
Glama
warengonzaga

Relay Protocol MCP Server

by warengonzaga
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Relay Protocol MCP Server

Model Context Protocol (MCP) server for the Relay Protocol REST API enabling cross-chain bridging and token swapping operations.

Features

  • Cross-Chain Bridging - Bridge tokens between 50+ blockchain networks

  • Multi-Chain Swaps - Aggregate tokens from multiple chains into single destination

  • Real-Time Pricing - Get current token prices across all supported chains

  • Request Monitoring - Track execution status and transaction details

  • Currency Discovery - Browse 1000+ supported tokens with filtering

  • Zero Configuration - No API keys required (free public API)

  • Type Safety - Full TypeScript support with comprehensive validation

Quick Start

Option 1: Local Setup (Claude Desktop)

# Install and build pnpm install && pnpm build # Run development server pnpm dev # Run production server pnpm start

Cloud Deployment (SSE transport)

Deploy to Railway, Heroku, Render, or any cloud platform:

# Build the server pnpm build # Start SSE server (uses PORT from environment or 3000) pnpm start:sse # Or for development pnpm dev:sse

See RAILWAY.md for detailed Railway deployment guide.

MCP Integration

Stdio Transport (Local - Claude Desktop)

Add to your Claude Desktop configuration file:

Config Location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "Relay Protocol": { "command": "node", "args": ["/absolute/path/to/relay-protocol-mcp-server/dist/index.js"] } } }

Option 2: Cloud Deployment (Railway)

Deploy Steps:

  1. Push your code to GitHub

  2. Go to railway.app → "New Project" → "Deploy from GitHub repo"

  3. Select your repository (Railway auto-detects configuration)

  4. Get your deployment URL: https://your-app.railway.app

Claude Desktop Configuration:

{ "mcpServers": { "Relay Protocol": { "transport": "sse", "url": "https://your-app.railway.app/sse" } } }

Test Your Deployment:

curl https://your-app.railway.app/health # Response: {"status":"healthy","server":"Relay Protocol","version":"0.1.0","transport":"sse"}

Deployment Info:

  • Free tier: $5/month credits (plenty for personal use)

  • Memory usage: ~50-100MB RAM

  • Auto-sleeps after 30 minutes of inactivity

  • Railway CLI: npm i -g @railway/cli (optional)

Available Tools (9 total)

Tool

Purpose

Example Use Case

relay_get_chains

List supported blockchain networks

"Show me all chains Relay supports"

relay_get_token_price

Get real-time token prices

"What's the price of USDC on Ethereum?"

relay_get_currencies

Discover tokens with advanced filtering

"Show verified tokens on Arbitrum"

relay_get_quote

Generate bridging/swap quotes

"Quote bridging 100 USDC from Ethereum to Polygon"

relay_swap_multi_input

Execute multi-chain swaps

"Swap ETH + USDC from multiple chains to USDC on Base"

relay_get_execution_status

Track request progress

"Check status of my bridge transaction"

relay_get_requests

Monitor request history

"Show my recent cross-chain transactions"

relay_transactions_index

Index transactions for tracking

"Register this transaction for monitoring"

relay_transactions_single

Index specific transfers/wraps

"Track this specific transfer operation"

Example Prompts

# Bridge tokens "Bridge 100 USDC from Ethereum to Polygon" "What chains can I bridge USDC between?" # Multi-chain swaps "Swap all my USDC from Ethereum and Polygon to ETH on Arbitrum" "Consolidate my tokens from multiple chains into USDC on Base" # Price discovery "Show current ETH prices across all chains" "What's the cheapest way to get USDC on Optimism?" # Currency discovery "Find all stablecoins available on Polygon" "Show me verified tokens with bridging support"

Development

pnpm typecheck # Type checking pnpm dev # Development with auto-reload pnpm build # Production build pnpm start # Start production server

Project Structure

src/ ├── client/ # HTTP client and error handling ├── tools/ # 9 MCP tool implementations ├── types/relay.ts # Complete TypeScript definitions ├── config.ts # API configuration ├── index.ts # Stdio transport (local) └── server.ts # SSE transport (cloud)

Troubleshooting

"No available tools" in Claude:

  1. Verify absolute path in config is correct

  2. Test server: echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/index.js

  3. Restart Claude Desktop after config changes

  4. Ensure Node.js >= 20.0.0 and pnpm build completed

Connection issues:

  • Run pnpm build before starting

  • Check server starts without errors: pnpm dev

  • Verify JSON syntax in Claude config file

Requirements

  • Node.js >= 20.0.0

  • pnpm package manager

API Reference

Full access to Relay Protocol REST API with TypeScript types and validation. The Relay Protocol supports:

  • 50+ Blockchain Networks including Ethereum, Polygon, Arbitrum, Optimism, Base, etc.

  • 1000+ Tokens with real-time pricing and bridging support

  • Free Public API with no rate limits or authentication required

  • Production-Ready infrastructure handling millions in daily volume

License

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/warengonzaga/relay-protocol-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server