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)

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