Agent Data Tools: Prices and DeFi
50 tools: token prices, wallet and contract risk, liquidity pools, FX. 25 free calls.
Description from the maker (original English)
Best-price token swaps on EVM networks through a non-custodial contract: quotes and trade status.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
AuthorizationValues 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.
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.
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.
Authorization secret HTTP headerThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
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_networksThe 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_infoWhat 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_quoteThe 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_statusWhere 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.
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
The registry name was verified against the domain soheil.fi (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Responded in 368 ms (HTTP 200)
No sign-in needed
Read 4 tool descriptions and found no hidden instructions to the AI
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
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.
You need to fill in: Authorization
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.
The GitHub repo last changed –, and the latest version (1.0.0) reached the registry today.
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.
In the same category: Agent Data Tools: Prices and DeFi, Agent Data Tools: Chain data, Highwire
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
50 tools: token prices, wallet and contract risk, liquidity pools, FX. 25 free calls.
360 tools: balances, blocks, gas, txs and logs on 5 EVM chains, plus Bitcoin. 25 free calls.
Trade, launch and research higher.fun coins on Solana, from any AI agent. Unsigned or policy-signed.
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.
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.
https://api.soheil.fi/v1/mcp0.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.
npm install github:soheil-fi/soheil-router
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.
| Method | Key | Returns |
|---|---|---|
getNetworks() | no | Live networks, our contract and the contracts a trade may call |
getInfo() | no | Fee, limits, docs |
getQuote(request) | yes | Price, minimum received, fees, approval address, transaction |
getStatus(chainId, txHash) | yes | PENDING, DONE, FAILED, NOT_OURS or NOT_FOUND |
waitForTrade(chainId, txHash) | yes | getStatus 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.
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" } } } }
bigint, never JavaScript numbers.fromAmount, never an unlimited amount.Built by Soheil.fi. Questions: support@soheil.fi
MIT