omniroute-bridge-mcp
OfficialEnables cross-chain bridging and multi-wallet gas refueling involving Ethereum, with read-only quotes, unsigned transaction plans, and fee estimates for tokens such as USDC and ETH.
Enables cross-chain bridging and gas funding involving Optimism as a source or destination network, returning unsigned plans and live quote data.
Enables cross-chain bridging to Polygon, including Polymarket onboarding that targets Polygon bridged USDC.e and optional POL gas refueling.
Enables cross-chain bridging involving Solana, preserving non-EVM Relay step data and returning unsigned Solana transaction plans.
OmniRoute Bridge MCP
One terminal for cross-chain funding, platform onboarding, and multi-wallet gas.
Zero API keys. Zero npm runtime dependencies. MIT-licensed Node.js SDK, CLI, and MCP server. Supports Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Smart Chain, HyperEVM, and Solana.
Free to install and use: no subscription or API-key purchase. Every Relay quote includes a 30 bps (0.30%) integrator fee, plus applicable Relay and network fees. It is not fee-free bridging. Fast routes may settle in roughly 2 seconds, but sub-3-second execution is not guaranteed; quote latency, approvals, network confirmation and final settlement vary. Always use the live quote estimate.
Quick start
Run directly from GitHub without cloning or waiting for an npm publication. No secret or environment variable is needed.
Claude Desktop, Cursor and Windsurf
Use this entry in your client's MCP configuration:
{
"mcpServers": {
"omniroute": {
"command": "npx",
"args": ["-y", "github:c-viper-work/omniroute-bridge-mcp", "mcp"]
}
}
}Or run these one-line CLI commands:
npx -y github:c-viper-work/omniroute-bridge-mcp chains --json
npx -y github:c-viper-work/omniroute-bridge-mcp mcpFrom a local source checkout (no installation required):
node bin/omniroute.js chains --json
node bin/omniroute.js quote --from base --to arbitrum --token USDC --to-token ETH --amount 10 --json
npm test
npm startFor a local MCP checkout, use "command": "node" and "args": ["/absolute/path/to/omniroute-bridge-mcp/bin/omniroute.js", "mcp"].
Try asking: “Quote 10 USDC from Base to native POL on Polygon,” or “Plan gas funding for these three wallets.” All six tools return unsigned plans and never hold keys, sign, broadcast, or trade.
Publication and GitHub Pages deployment are separate maintainer actions; this repository does not automatically publish itself.
Related MCP server: persistenceone-bridgekitty
Verify safety in 60 seconds
Zero npm dependencies: package.json has
"dependencies": {}, nodevDependencies, and no install scripts.Compact, unminified source: approximately 850 lines of readable ESM JavaScript across
src/anddocs/(excluding byte-identical browser copies of shared modules), with zero build step.Read-only MCP & CLI: all 6 tools never accept, store, or touch private keys or seed phrases;
executeUrldeep links carry only route intent parameters, never raw transaction calldata. Inspect src/service.js.Strict browser CSP: docs/index.html locks
connect-srcexclusively tohttps://api.relay.link, withdefault-src 'none'andscript-src 'self'.Bounded wallet preflight: docs/lib/wallet.js verifies before any EVM
eth_sendTransactionthat ERC-20approve/transfercalls target only the quoted input token and never exceed the quoted input amount. docs/app.js caps deep-link slippage at <= 500 bps (5.00%) and warns on custom recipients.
Browser wallet signing in the Web Terminal supports all 7 EVM source chains: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Smart Chain, and HyperEVM, using an injected EIP-1193 wallet. Solana source routes return unsigned transaction plans for external signing.
CLI
# List supported chains and tokens
node bin/omniroute.js chains --json
# Read-only bridge preview
node bin/omniroute.js quote --from solana --to base --token USDC --to-token ETH --amount 10 --json
# Include real source and destination wallet addresses for executable quote data
node bin/omniroute.js quote --from base --to arbitrum --token USDC --to-token ETH --amount 10 --sender YOUR_EVM_ADDRESS --recipient YOUR_EVM_ADDRESS --json
# Polymarket: Polygon USDC.e plus an additional approximately $2 source spend for POL
node bin/omniroute.js polymarket --from base --token USDC --amount 50 --recipient YOUR_POLYGON_ADDRESS --json
# Skip the extra gas route
node bin/omniroute.js polymarket --from base --token USDC --amount 50 --no-gas --json
# HyperEVM native HYPE
node bin/omniroute.js hyperliquid --from arbitrum --token USDC --amount 25 --mode hyperevm_hype --json
# Prepare Arbitrum USDC for the official Hyperliquid deposit flow
node bin/omniroute.js hyperliquid --from base --token USDC --amount 25 --mode arbitrum_usdc --json
# Spend 2 source USDC per destination wallet to buy Polygon POL
node bin/omniroute.js refuel --from base --token USDC --to polygon --amount-per-wallet 2 --recipients ADDRESS_1,ADDRESS_2 --sender YOUR_SOURCE_ADDRESS --json
node bin/omniroute.js status --request-id RELAY_REQUEST_ID --json
node bin/omniroute.js --help--sender is supported by all quote-producing commands. Without it, returned data is marked previewOnly; do not sign preview calldata. For cross-VM routes, also specify the real destination recipient. --slippage-bps 50 means 0.50% on the quote command. --gas-usd changes the additional Polymarket gas budget (0–50 USD); --no-gas ignores that budget. Value flags also accept --flag=value. --mode both quotes two full-size Hyperliquid funding routes and doubles the source input budget.
Onboarding boundaries
Polymarket: the preset targets Polygon bridged USDC.e (
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174), distinct from native USDC. Optional gas is a separate POL route, skipped when the source is already native Polygon POL. Use the intended platform wallet; a transfer to an arbitrary EOA does not create or fund every kind of Polymarket account automatically. Account setup, approvals and current platform deposit requirements still apply.HyperEVM: native HYPE on chain 999 funds EVM gas. This is not Hyperliquid L1 perpetuals collateral.
Arbitrum USDC: prepares funds for the official Hyperliquid deposit flow; it does not call Bridge2. Keep Arbitrum ETH for the separate deposit transaction and check the platform's current minimums.
Gas refuel:
amountPerWalletis input in the source token. Output native gas is quoted after fees. Up to 20 recipients, four concurrent quote requests, ordered unsigned steps. Duplicate recipients mean repeated allocations. Execution is not atomic; track each submitted transaction separately.USD gas budget: estimated using the primary quote's source USD valuation. The gas route is additional spend, not deducted from the primary amount. It is not a guarantee of that many dollars of POL after fees; missing or invalid USD pricing causes an explicit error. The primary input/output USD ratio must be between 0.5 and 2.0.
See Polymarket's official bridge guide and Hyperliquid onboarding for the destination platform flows.
Node.js SDK
import {
getBridgeQuote,
getPolymarketOnboardPlan,
getHyperliquidOnboardPlan,
planMultiWalletGasRefuel,
checkBridgeOrderStatus,
fetchAppFeeBalances
} from 'omniroute-bridge-mcp';
const quote = await getBridgeQuote({
fromChain: 'base', toChain: 'arbitrum',
fromToken: 'USDC', toToken: 'ETH', amount: '10',
userAddress: 'YOUR_SOURCE_ADDRESS',
recipientAddress: 'YOUR_DESTINATION_ADDRESS',
slippageBps: 50
});
console.log(quote.currencyOut, quote.fees, quote.steps);
// No signing occurs. Review and execute with your own wallet integration.In a source checkout, import from ./src/index.js. The illustrative address placeholders must be replaced with valid addresses. To preview instead, omit the address fields.
All network methods accept a final options object: { fetchImpl, timeoutMs, signal, feeRecipient, feeBps }. Default timeout is 15 seconds. Injectable fetch supports deterministic offline tests. Fee overrides are explicit testing/configuration options; CLI and MCP expose no fee override. There is no automatic retry of quotes or transactions.
resolveToken(chain, rawAddress, customDecimals) supports custom tokens with explicit decimals. getBridgeQuote accepts fromTokenDecimals / toTokenDecimals for raw addresses. Registered tokens use the audited registry decimals; arbitrary mint/contract metadata is not fetched. Address validation checks syntax and Solana decoded length, not ownership or token safety.
Use decimal strings for exact amounts. parseUnits returns BigInt, rejects zero, negatives, scientific notation, excess decimals and uint256 overflow. JavaScript numbers cannot recover precision already lost before the call. formatUnits returns an exact decimal string, with support for zero and negative values for display.
Quote result
Every quote and onboarding/refuel plan includes an executeUrl: a clickable Web Terminal link containing only route intent, never calldata. MCP agents should always show this link. Opening it fetches a fresh quote; preview quotes must never be executed.
Results include requestId, chain metadata, input/output amounts and USD values, minimum output, rate, impact, estimated seconds, gas/relayer/app fees, payload, quotedAt, previewOnly and ordered steps. Missing upstream estimates are null, never invented. Relay step data and check endpoints are preserved, including non-EVM data. A signature or Solana transaction cannot be passed to EVM eth_sendTransaction.
MCP tools
Tool | Purpose |
| Registry, presets and fee disclosure |
| Cross-chain unsigned quote |
| Polygon USDC.e and optional POL |
| HyperEVM HYPE / Arbitrum USDC |
| Up to 20 native gas allocations |
| Relay intent status v2 |
Each tool has a title, read-only/non-destructive/idempotent annotations and descriptions on every parameter. openWorldHint is false only for the local registry tool. The idempotent annotation describes absence of transaction side effects; live quotes and request IDs can change. Metadata coverage is locally tested; no external Glama grade is claimed.
The stdio server accepts modern newline-delimited JSON and legacy Content-Length framing (UTF-8 byte counts), fragmented frames, notifications, and initialize, ping, tools/list, tools/call, resources/list, prompts/list. Responses use each request's framing. Stdout contains only protocol responses in MCP mode. Messages are limited to 1 MiB.
Fees and Relay integration
Every HTTP quote request includes:
{
"appFees": [{
"recipient": "0x8c2279495094C284e1293cdE9DBC52cc4f55C6bd",
"fee": "30"
}]
}The dedicated project wallets are EVM 0x8c2279495094C284e1293cdE9DBC52cc4f55C6bd and Solana FJCcoqJHmoJyuthUY773gnxBsAY8yQuAgfYwL3zETVVW; both are disclosed by listSupportedRoutes().integratorFee.
The Relay app fee recipient is always an EVM address, including Solana routes. The default is centralized and the HTTP boundary reconstructs the fee field even when a low-level caller omits it. Default balances can be queried with fetchAppFeeBalances(); there is no automatic fee withdrawal.
Endpoints: POST https://api.relay.link/quote, GET /intents/status/v2?requestId=..., GET /app-fees/{wallet}/balances. This project intentionally uses the requested /quote endpoint. Relay currently documents it as deprecated; compatibility and public rate limits are upstream concerns. The project does not promise unlimited API access or perpetual upstream availability. HTTP, JSON, timeout and cancellation errors propagate clearly; no private key or API key is required.
Architecture
CLI / MCP client / Node.js application
|
service.js presets, validation, batch aggregation, tool schemas
|
relay.js HTTP boundary, fees, timeout, normalization
|
api.relay.link unsigned quote / status
constants.js chain registry and exact amount arithmeticsrc/index.js exports the public SDK. src/mcp-server.js provides stdio transport. src/cli.js handles CLI arguments; bin/omniroute.js is the executable entry. No signing keys, telemetry, database, server account or hosted backend are needed.
Development and release
npm test
node --check src/service.js
npm pack --dry-run
# Optional, with Docker installed:
docker build -t omniroute-bridge-mcp .
docker run --rm -i omniroute-bridge-mcpTests use native node:test, node:assert, deterministic Relay fixtures, stream fragmentation and CLI subprocesses. They never spend funds. They cover fee injection, EVM/Solana directions, input precision and validation, all service/tool/CLI entry points and protocol framing. Mock tests do not establish live liquidity, settlement performance, browser wallet compatibility or platform crediting.
Always verify recipient addresses and wallet transaction details before signing, never execute stale quotes, and never resend a transaction whose submission status is unknown. Nothing in the SDK, CLI, or MCP server automatically broadcasts a transaction.
License
MIT · maintained by c-viper-work.
Static web app
Open an executeUrl to prefill the route and automatically request a fresh live quote when an amount (and refuel recipients) is present. Copy route link shares the current reviewed route; the link also appears in the unsigned JSON / CLI details. Links can contain wallet addresses. Unsupported chains or custom tokens require manual review rather than automatically quoting a different token. Wallet network changes preserve the connection; account changes update the sender. Both invalidate stale quotes. Signing still requires explicit wallet confirmation.
Serve docs/ over HTTPS (GitHub Pages) or a local HTTP server, for example
python3 -m http.server 8080 --directory docs. Open http://localhost:8080.
The app calls Relay directly, with no keys or third-party JavaScript. Wallet
execution requires an injected EIP-1193 provider; CLI/JSON export also works
without a wallet. CLI commands request fresh unsigned plans, never broadcast.
Quotes must pass the 60-second freshness check before the first send. Subsequent transactions use that first-send time for quote freshness, with a batch limit of transaction count × receipt timeout (120 seconds per transaction by default). Chain/account changes require a new quote. Direct native values and input-token ERC-20 approve/transfer calls are bounded by the quoted input.
Transaction hashes remain visible after failures; never automatically retry a
submitted plan. Source confirmation and Relay destination delivery are separate.
After changing shared quote modules, synchronize the deployed browser copies:
cp src/constants.js src/relay.js src/service.js docs/lib/
npm testTests enforce byte equality for these modules. No build step is required.
Available Tools
6 toolscheck_bridge_order_statusARead-onlyIdempotent
Read Relay intent status v2 for a request ID. Does not submit or retry transactions.
| Name | Required | Description | Default |
|---|---|---|---|
| requestId | Yes | Relay requestId returned by the quote or executable step, at most 256 characters. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false, and openWorldHint=true, so the safety profile is covered. The description reinforces the read-only boundary but adds little beyond annotations, such as rate limits or return details, so a baseline 3 is appropriate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with the core action front-loaded. Every clause earns its place by stating what is read and what is explicitly not done.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter status tool with strong annotations, the description is largely complete and makes the non-mutating scope clear. It could say more about what status information is returned, since there is no output schema, but the essential invocation context is present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the requestId parameter is already documented with its origin from quote or executable steps and a 256-character limit. The description only repeats that a request ID is required, adding no further parameter semantics beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: "Read Relay intent status v2 for a request ID." It also explicitly rules out submission and retry behavior, which helps distinguish it from action-oriented bridge tools in the sibling set.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It makes the usage context clear by tying the tool to a request ID and stating that it does not submit or retry transactions. It does not explicitly name an alternative or say when not to use it, but the boundary is sufficiently clear for a read-only status check.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_cross_chain_bridge_quoteARead-onlyIdempotent
Fetch a Relay quote with fee breakdown and unsigned steps. Never signs or broadcasts; missing sender creates a preview. Always show executeUrl to the user for 1-click browser wallet signing.
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Positive human-readable source-token amount as a decimal string; no exponent notation. Use strings to preserve precision. | |
| toChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| toToken | No | Destination token symbol, native, or raw contract/mint address. | |
| fromChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| fromToken | No | Source token symbol such as ETH, USDC or native; amounts are denominated in this token. | |
| slippageBps | No | Maximum slippage in basis points: 50 means 0.50%. Omit for Relay automatic tolerance. | |
| userAddress | No | Real sender address on the source chain. Omit only for a read-only preview that cannot be executed. | |
| toTokenDecimals | No | Required decimal precision for an unregistered raw destination token address. | |
| recipientAddress | No | Destination wallet address, matching the destination chain VM. Verify the platform wallet before onboarding. | |
| fromTokenDecimals | No | Required decimal precision for an unregistered raw source token address. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish readOnlyHint, idempotentHint and destructiveHint=false, so the safety bar is low; the description still adds value by confirming 'Never signs or broadcasts' and explaining that an omitted sender downgrades the call to a non-executable preview. It does not mention rate limits or freshness/expiry of the quote.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences: what is returned first, then the non-signing guarantee and the executeUrl directive. Very little waste, though the 'Always show executeUrl' instruction is a presentation rule rather than a definition concern.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 10-parameter, no-output-schema tool, the description usefully previews the return shape ('fee breakdown and unsigned steps', executeUrl) and the read-only preview mode. Remaining gaps are minor since token/chain tokenomics and decimals validation are fully covered by the schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all ten parameters including the decimals and slippageBps semantics. The description's note that a missing sender yields a preview reiterates what userAddress's schema text already says, adding no new parameter meaning beyond the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource ('Fetch a Relay quote') and enumerates the payload ('fee breakdown and unsigned steps'), which an agent can distinguish from check_bridge_order_status and list_supported_chains_and_tokens. It stops short of explicitly naming the sibling it replaces.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It does give real usage direction ('missing sender creates a preview', 'Always show executeUrl to the user for 1-click browser wallet signing'), but that is invocation etiquette rather than routing guidance. No sibling alternative or when-not-to-use condition is stated, so the agent must infer that a quote precedes onboarding and status checks.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
hyperliquid_one_click_onboardARead-onlyIdempotent
Plan HyperEVM HYPE or Arbitrum USDC funding. L1 deposits remain a separate action. Always show executeUrl to the user for 1-click browser wallet signing.
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Positive human-readable source-token amount as a decimal string; no exponent notation. Use strings to preserve precision. | |
| fromChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| fromToken | No | Source token symbol such as ETH, USDC or native; amounts are denominated in this token. | |
| targetMode | No | Funding destination. both quotes two routes, each spending the entire specified source amount. | hyperevm_hype |
| userAddress | No | Real sender address on the source chain. Omit only for a read-only preview that cannot be executed. | |
| recipientAddress | No | Destination wallet address, matching the destination chain VM. Verify the platform wallet before onboarding. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and destructiveHint=false, and 'Plan' is consistent with that non-executing profile. The description adds real value beyond annotations: it tells the agent to surface the executeUrl for browser wallet signing, which is a behavioral obligation not captured in any structured field.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short, front-loaded sentences with no padding; the scope and the executeUrl directive both land early. Slightly terse given the tool's complexity, but nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description's callout of executeUrl meaningfully informs what the agent will receive and must do with it. It stops short of describing the broader response (e.g., quoted routes), but covers what matters for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so every parameter is already documented. The description adds no per-parameter detail (e.g., how fromChain aliases or targetMode 'both' interact), so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Plan') and resource ('HyperEVM HYPE or Arbitrum USDC funding'), and explicitly carves out that 'L1 deposits remain a separate action'. An agent can tell this is an onboarding/funding-planning tool, though it does not name which sibling to use instead.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implies usage for onboarding and notes that L1 deposits are out of scope, but gives no explicit routing against siblings like get_cross_chain_bridge_quote or list_supported_chains_and_tokens. The 'when' is inferred rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_supported_chains_and_tokensARead-onlyIdempotent
List eight supported chains, token addresses, onboarding presets and the disclosed 30 bps integrator fee.
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered structurally. The description adds genuinely non-derivable context: the breadth of coverage (eight chains), that onboarding presets are included, and notably the disclosed 30 bps integrator fee, which an agent could not infer. No mention of caching or response freshness, hence not a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One front-loaded sentence with no filler; the most important payload items (chains, token addresses) come first. The hardcoded 'eight' is a slight liability since the count may drift, but the sentence itself is tight.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, so the description correctly carries the burden of describing what is returned, and it does so for a zero-required-parameter listing tool with a fully documented optional filter. It only misses stating that omitting 'chain' returns the full set and how presets map to the onboarding siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single optional 'chain' filter is fully documented there, so the baseline is 3. The description describes only the return payload and adds no meaning about how the chain filter narrows results or what happens when it is omitted.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (List) plus a concrete resource set: supported chains, token addresses, onboarding presets, and the integrator fee. This is clearly distinguishable from the sibling quote/onboard/refuel/status tools. It stops short of naming any sibling explicitly, so it lands at 4 rather than 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to call this versus the onboarding siblings (polymarket_one_click_onboard, hyperliquid_one_click_onboard) that likely consume this data, nor on whether it should be called before quoting or bridging. The listing nature implies a discovery/discovery-first use, but nothing is stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
multi_wallet_gas_refuelARead-onlyIdempotent
Quote native gas delivery for 1–20 recipients without broadcasting, preserving recipient order. Always show executeUrl to the user for 1-click browser wallet signing.
| Name | Required | Description | Default |
|---|---|---|---|
| fromChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| fromToken | No | Source token symbol such as ETH, USDC or native; amounts are denominated in this token. | |
| recipients | Yes | Ordered list of 1–20 destination addresses. Duplicate addresses intentionally receive multiple allocations. | |
| targetChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| senderAddress | No | Real sender address on the source chain. Omit only for a read-only preview that cannot be executed. | |
| amountPerWallet | Yes | Positive decimal source-token amount spent for EACH wallet, not the amount of destination gas. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint/idempotent/non-destructive, and the description is consistent with that while adding real value: it clarifies that nothing is broadcast and that the result yields an executeUrl the agent must surface for signing. That return-value behavior is important since there is no output schema. It stops short of describing what the quote payload contains (fees, delivery estimates) or timing/expiry.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences, front-loaded with the action and constraints, followed by the one operational instruction that changes agent behavior. No filler or restated name/title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a quote-only tool with no output schema, the description covers the key gap — that the response feeds a browser-signing flow via executeUrl — plus the non-broadcast guarantee. Missing is any indication of what the quote itself returns (amounts, fee breakdown, validity window), which would complete the picture.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all six parameters (including the per-wallet denomination and senderAddress preview mode) are already fully documented in the schema. The description only echoes the recipient count and ordering constraint that the schema's recipients description also covers, adding no new parameter-level detail.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific action and resource ('Quote native gas delivery') and scopes it precisely ('for 1–20 recipients without broadcasting, preserving recipient order'). It does not explicitly name or distinguish itself from the adjacent quote tool get_cross_chain_bridge_quote, leaving the gas-refuel vs bridge-quote distinction to be inferred from the resource noun.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The second sentence gives a post-call workflow instruction (show executeUrl for browser wallet signing), which implies this is the quote step preceding an execution step. However, there is no explicit when-to-use/when-not guidance, no mention of the sibling quote tool as an alternative, and no stated prerequisites beyond the senderAddress hint in the schema.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
polymarket_one_click_onboardARead-onlyIdempotent
Plan Polygon USDC.e plus optional POL gas. Extra gas spends additional input; this does not create a trading account. Always show executeUrl to the user for 1-click browser wallet signing.
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Positive human-readable source-token amount as a decimal string; no exponent notation. Use strings to preserve precision. | |
| fromChain | Yes | Supported chain slug, alias or numeric chain ID as a string (for example base, arb, solana, 8453). | |
| fromToken | No | Source token symbol such as ETH, USDC or native; amounts are denominated in this token. | |
| userAddress | No | Real sender address on the source chain. Omit only for a read-only preview that cannot be executed. | |
| includeGasTopup | No | Whether to quote a separate native POL top-up in addition to the full primary input. | |
| recipientAddress | No | Destination wallet address, matching the destination chain VM. Verify the platform wallet before onboarding. | |
| gasTopupAmountUsd | No | Approximate USD source spend for POL gas, before fees, valued from the primary quote; zero disables it. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already flag readOnlyHint=true and idempotent, and the description is consistent with that by clarifying the tool only plans rather than creating an account. It adds genuinely non-schema information: the response carries an executeUrl that must be surfaced to the user, and extra gas costs additional input on top of the primary amount. It stops short of describing plan validity/expiry or what happens if userAddress is omitted.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short clauses with the scope constraint front-loaded and the critical UI instruction at the end; nothing is padded. The phrase 'Extra gas spends additional input' is slightly awkward and could be tighter, but the size is well matched to the tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 7 parameters and no output schema, the description compensates by disclosing the executeUrl in the response and the plan-then-sign workflow. Annotations already cover the safety profile. Minor gaps remain around preview-mode limitations and whether quotes expire, but nothing blocking correct invocation is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameters are already well documented (including the gasTopupAmountUsd range and the preview-only meaning of an omitted userAddress). The description's line 'Extra gas spends additional input' reinforces the includeGasTopup/gasTopupAmountUsd semantics but largely restates what the schema already says ('in addition to the full primary input').
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and outcome: 'Plan Polygon USDC.e plus optional POL gas', which tells an agent this is a quoting/planning tool, not an executor. The clause 'this does not create a trading account' usefully delimits scope. It never names or contrasts with siblings such as hyperliquid_one_click_onboard or get_cross_chain_bridge_quote, so sibling differentiation is left to the tool name.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied through the workflow instruction 'Always show executeUrl to the user for 1-click browser wallet signing', which frames this as the planning step before an out-of-band signing step. However, there is no explicit when-to-use/when-not-to-use guidance and no reference to the obvious alternative onboarding or bridge-quote siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.3.1- Changed
polymarket_one_click_onboard1 field changed- added
Input schema / properties / gasTopupAmountUsd / maximumAdded value: +50
6 tool updates
v1.0.0- First observed
check_bridge_order_status - First observed
get_cross_chain_bridge_quote - First observed
hyperliquid_one_click_onboard - First observed
list_supported_chains_and_tokens - First observed
multi_wallet_gas_refuel - First observed
polymarket_one_click_onboard
TDQS
Scored across 6 tools
Each tool targets a distinct action: discovery (list_supported_chains_and_tokens), quoting (get_cross_chain_bridge_quote), protocol-specific onboarding (polymarket, hyperliquid), gas refueling, and status polling. The two onboarding tools are near-identical in shape but clearly separated by protocol name, and the descriptions differentiate the onboarding plans from the generic bridge quote.
Half the tools follow a clean verb_noun pattern (list_supported_chains_and_tokens, get_cross_chain_bridge_quote, check_bridge_order_status), but the onboarding tools use entity-first ordering (polymarket_one_click_onboard) and multi_wallet_gas_refuel has no leading verb. The mixed conventions are still readable but break the pattern.
Six tools is a tight, well-scoped surface for a bridge/onboarding workflow: discovery, quoting, two protocol-specific onboarding paths, refuel, and status. No tool feels redundant or padded.
The surface covers the full read-only lifecycle: list supported assets, get quotes/plans, and poll order status, with signing explicitly handed off via executeUrl. Minor gaps exist (e.g. no fee-only or supported-recipient lookup separate from the list tool), but agents can work around them.
Maintenance
Related MCP Connectors
Li.Fi tools over MCP: cross-chain quotes, routes, execution status, chains, tokens, balances.
Multi-chain wallet MCP. 18 tools: balance, swap, bridge, stake, claim. Pay-per-call USDC (x402 v2).
Gasless MEV-protected swaps + cross-chain quotes across EVM chains — incl. tokenized stocks.
Swap, bridge and get gas on 6 EVM chains. Each plan states its outcome before you sign. No API key.
Related MCP Servers
AlicenseAqualityDmaintenancedeBridge MCP finds optimal cross-chain swap routes, check fees and conditions, and initiate non-custodial trades across major blockchain networks. Supported: Ethereum, Solana, Arbitrum, Base, BNB Chain, Polygon, Optimism, Avalanche, Linea, Berachain, Tron, Cronos, Gnosis, Monad, Sonic, Flow, HyperEVM, Sei, Story, Injective, Abstract, MegaETH, Mantle, Plasma, Zilliqa, Sophon, Bob, Neon, and more587 npm31MIT- AlicenseAqualityDmaintenanceCross-chain bridge aggregator MCP server for AI agents. Compares routes across LI.FI, deBridge, Relay, Across and Squid to find the best rate. Use when an agent needs to bridge or swap tokens between EVM chains, Solana, or Cosmos. The aggregator of aggregators.1286 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables cross-chain transactions (swap, send, balance) on 10 blockchains from a single NEAR account, designed for AI agents and humans via MCP.6Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMulti-chain MCP server enabling AI agents to interact with Arbitrum — ERC-8004 identity registration, GMX ecosystem integration, cross-chain reputation via RepuLayer, and 37 governance tools across 6 chains.11 npmMIT