# Soheil Router

The Soheil Router MCP server for Claude Code finds token swap and bridge quotes across networks. It also checks trade status.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: soheil-fi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/soheil-fi/soheil-router
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/soheil-router

## What it does

Soheil Router returns quotes for token swaps and cross-network transfers, then lets an agent check a trade’s status. It compares offers from DEXes, aggregators and bridges. For trades on EVM networks, execution goes through the router contract; other supported networks may return a deposit address, a transaction, or wallet messages.

API requests for quotes and trade status need an account key, `SOHEIL_ROUTER_KEY`. The router charges 0.1% per trade; trades through its contract can include an additional fee of up to 0.9%. The MCP server connects over HTTP at `https://api.soheil.fi/v1/mcp`.

## Requirements
- Remote server: `https://api.soheil.fi/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http router https://api.soheil.fi/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add soheil-router --url https://api.soheil.fi/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "soheil-router": {
            "url": "https://api.soheil.fi/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "soheil-router": {
            "type": "http",
            "url": "https://api.soheil.fi/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http soheil-router https://api.soheil.fi/v1/mcp
```

## When to use it
- find a quote for swapping tokens across networks
- compare swap offers from DEXes and aggregators
- check the status of a submitted trade
- get a route for bridging tokens between networks

## Example prompts
- Find a quote to swap ETH for USDC on Base.
- Compare routes for moving USDC from Base to Arbitrum.
- Check the status of my trade on Base.

## Similar
- [expo-router](https://affpapa.org/en/nevibecode/skills/expo-router.md) — skill · 34500 installs
- [nextjs-app-router-patterns](https://affpapa.org/en/nevibecode/skills/nextjs-app-router-patterns.md) — skill · 32529 installs
- [vue-router-best-practices](https://affpapa.org/en/nevibecode/skills/vue-router-best-practices.md) — skill · 16700 installs
- [clerk-react-router-patterns](https://affpapa.org/en/nevibecode/skills/clerk-react-router-patterns.md) — skill · 16300 installs
- [router](https://affpapa.org/en/nevibecode/skills/router.md) — skill · 12900 installs
- [tanstack-router-best-practices](https://affpapa.org/en/nevibecode/skills/tanstack-router-best-practices.md) — skill · 7200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
