Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

Soheil Router

by soheil-fiversion 1.0.0i★ –iRuns in the cloud
Registry namefi.soheil/router

Install

Overview

Description from the maker (original English)

Best-price token swaps on EVM networks through a non-custodial contract: quotes and trade status.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Crypto & blockchain
  • You need to fill in: Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http router https://api.soheil.fi/v1/mcp --header 'Authorization: your-value'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "router": {
      "url": "https://api.soheil.fi/v1/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "router": {
      "type": "http",
      "url": "https://api.soheil.fi/v1/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

  • Authorization secret HTTP header
    Bearer , free at https://soheil.fi/developers/dashboard/ (needed for quotes and trade status; listing networks works without it)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

  • get_networks

    The EVM networks where Soheil Router is live: chain id, name, our contract, its fee and fee wallet, and the contracts a trade may call. No API key needed.

  • get_api_info

    What the Soheil Router API is: version, router fee, the most an integrator may add, how keys are given, and where the docs and OpenAPI spec are. No API key needed.

  • get_quote

    The best price for a token swap on one network and the transaction that makes it, through our contract. Returns toAmount, toAmountMin (enforced on-chain), the fees, approvalAddress (approve it for exactly fromAmount first unless fromToken is the coin) and transactionRequest for t

  • get_trade_status

    Where a sent trade stands, from its transaction on chain: PENDING, DONE (with what was paid and received), FAILED, NOT_FOUND or NOT_OURS. Needs an API key.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain soheil.fi (the registry checks domain ownership)

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 368 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 4 tool descriptions and found no hidden instructions to the AI

Compared with others in Crypto & blockchaini

  • More stars than 0% of the other 1609 servers in this category
  • Published to the registry more recently than 100% of the other 1609 servers in this category
  • Basic checks equal to or better than 100% of the other 1609 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Soheil Router safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.0) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Agent Data Tools: Prices and DeFi, Agent Data Tools: Chain data, Highwire

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

360 tools: balances, blocks, gas, txs and logs on 5 EVM chains, plus Bitcoin. 25 free calls.

Runs in the cloudUpdated today
Install

Highwire

by HigherMaestro

Trade, launch and research higher.fun coins on Solana, from any AI agent. Unsigned or policy-signed.

Computer or cloudUpdated today
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Soheil Router

One API call for the best token swap price, and one transaction that makes it. Soheil Router compares prices across DEXes and aggregators on each network and executes the trade through its own contract: non-upgradeable, source verified on the explorers, and it holds no funds between trades.

  • Docs: https://soheil.fi/developers/docs/
  • Free API key: https://soheil.fi/developers/dashboard/
  • OpenAPI 3.1: https://api.soheil.fi/v1/openapi.json
  • For AI assistants: https://soheil.fi/developers/llms-full.txt · MCP server at https://api.soheil.fi/v1/mcp

Fees

0.1% (10 bps) to the router on each swap. You can add your own fee (up to 0.9%), paid to your wallet inside the same transaction: nothing to claim.

Install

npm install github:soheil-fi/soheil-router

Quick start

import { COIN, SoheilRouter } from "@soheil-fi/router";

const router = new SoheilRouter({ apiKey: process.env.SOHEIL_ROUTER_KEY }); // keep the key on your server

const quote = await router.getQuote({ fromChainId: 8453, // Base fromToken: COIN, // ETH toToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC fromAmount: 10n ** 15n, // 0.001 ETH, in wei fromAddress: "0xUserWallet", integratorBps: 30, // your fee: 0.3% });

// quote.approvalAddress → approve exactly quote.fromAmount first (null when selling the coin) // quote.transactionRequest → have the user's wallet send it unchanged const status = await router.waitForTrade(8453, txHash); // DONE, FAILED or NOT_OURS

A whole swap with viem is in examples/swap-viem.ts.

MethodKeyReturns
getNetworks()noLive networks, our contract and the contracts a trade may call
getInfo()noFee, limits, docs
getQuote(request)yesPrice, minimum received, fees, approval address, transaction
getStatus(chainId, txHash)yesPENDING, DONE, FAILED, NOT_OURS or NOT_FOUND
waitForTrade(chainId, txHash)yesgetStatus until the trade is final

Errors are thrown as SoheilRouterError with code (NO_ROUTE, RATE_LIMITED, UNAUTHORIZED…), the HTTP status and a message safe to show your users.

Use it from an AI assistant (MCP)

The API is also an MCP server (Streamable HTTP) with the tools get_networks, get_api_info, get_quote and get_trade_status.

claude mcp add --transport http soheil-router https://api.soheil.fi/v1/mcp \

--header "Authorization: Bearer $SOHEIL_ROUTER_KEY"

{ "mcpServers": { "soheil-router": { "url": "https://api.soheil.fi/v1/mcp", "headers": { "Authorization": "Bearer sk_your_key" } } } }

Good to know

  • Amounts are integer strings in the token's smallest unit; use bigint, never JavaScript numbers.
  • Approve exactly fromAmount, never an unlimited amount.
  • The user always signs in their own wallet: the API never holds keys or funds.

Built by Soheil.fi. Questions: support@soheil.fi

License

MIT

Ask PopNx