Skip to main content
Glama
Sign In
zerouter

zerouter

Official
by zerouter
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

zerouter MCP

MCP (Model Context Protocol) server for zerouter, the swap router on Robinhood Chain (chain id 4663).

It lets any MCP client (Claude, Cursor, and others) quote swaps with equity-aware guardrails: routing across on-chain Uniswap v3 and v4 plus Odos, with a Chainlink fair-price check and market-hours warnings for tokenized stocks.

The server is read-only. It quotes and returns calldata for the caller to sign; it never holds keys and never executes transactions.

Tools

  • get_quote: best swap quote for a pair. Accepts human decimal amounts (e.g. "1.5"), converts to base units using the token decimals, and returns the winning source, all source prices, and the guardrail block for stock-token swaps (oracle fair price, deviation in bps, market session, warnings). Pass taker to get firm calldata (to, data, value) ready to sign, and optionally recipient to route proceeds elsewhere.

  • get_token: symbol and decimals for an ERC-20 address on the chain.

  • health: API reachability and configured quote sources.

  • chain_info: static chain reference and usage notes.

Related MCP server: @getplexa/mcp

Install

npm install
npm run build

Use with Claude Code

claude mcp add zerouter -- node /path/to/mcp/dist/index.js

Use with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "zerouter": {
      "command": "node",
      "args": ["/path/to/mcp/dist/index.js"]
    }
  }
}

Configuration

  • ZEROUTER_API_URL (optional): override the API base. Defaults to https://api.zerouter.app.

No API keys are needed. Quote requests go only to the zerouter API, which routes against on-chain quoters over RPC, so no third party sees trade intent.

Example

Ask your client: "quote swapping 0.5 ETH to AAPL on Robinhood Chain". The get_quote result includes a guardrail like:

{
  "deviationBps": -34,
  "market": { "open": false, "reason": "weekend" },
  "warnings": [
    "us stock market is closed (weekend) - on-chain price can drift from the last real market price"
  ]
}

Negative deviationBps means the quote pays less than the oracle-fair amount.

License

MIT

Available Tools

4 tools
chain_infoChain infoA

Static reference: chain id, native token pseudo-address, and how token amounts and guardrails work on zerouter.

NameRequiredDescriptionDefault

No parameters

get_quoteGet swap quoteA

Get the best swap quote on Robinhood Chain (chain id 4663). Routes across on-chain Uniswap v3 and v4 plus Odos and returns the winning price. For swaps involving tokenized stocks it also returns a fair-price guardrail: the Chainlink oracle price, the deviation of the quote from it in bps, whether the US stock market is open, and plain-language warnings. Omit taker for an indicative price. Provide taker (the address that will send the transaction) to get firm calldata (to, data, value) ready to sign. This tool never executes anything, it only quotes.

NameRequiredDescriptionDefault
takerNoAddress that will execute the swap. Include it to receive firm calldata.
buyTokenYesToken to buy: an ERC-20 address on chain 4663, or "native" for ETH
recipientNoOptional address to receive the proceeds instead of the taker. Requires taker.
sellTokenYesToken to sell: an ERC-20 address on chain 4663, or "native" for ETH
sellAmountYesAmount to sell as a human decimal string, e.g. "1.5" for 1.5 tokens. Converted to base units automatically using the token decimals.
slippageBpsNoMax slippage in basis points, 1 to 5000. Default 100 (1%).
get_tokenGet token metadataA

Look up an ERC-20 token on Robinhood Chain by address. Returns its symbol and decimals. Errors if the address is not an ERC-20 token on this chain.

NameRequiredDescriptionDefault
addressYesERC-20 token address (0x...)
healthCheck router healthA

Check that the zerouter quote API is reachable and list its configured quote sources.

NameRequiredDescriptionDefault

No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 4 tool updatesv0.1.0
    • First observedchain_info
    • First observedget_quote
    • First observedget_token
    • First observedhealth
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a distinct purpose: get_quote retrieves swap quotes, get_token fetches token metadata, health checks API status, and chain_info provides static chain reference. No overlap or ambiguity between them.

Naming Consistency4/5

Most tools follow verb_noun pattern (get_quote, get_token), while health and chain_info use noun-style names. The pattern is readable and predictable, with minor deviation in non-get tools, but still clear.

Tool Count5/5

Four tools is well-scoped for a specialized quoting API. Each tool earns its place: core quote operation, token helper, health check, and reference info. No redundancy or missing essential functions.

Completeness4/5

The surface covers the primary lifecycle of a quoting service: getting quotes, token lookup, health monitoring, and chain reference. A minor gap is lack of token list/search, but not required for the core purpose.

Resources

Related MCP Connectors

Related MCP Servers

  • @getplexa/mcp

    plexa-xyz
    A
    license
    A
    quality
    C
    maintenance
    A Model Context Protocol server that gives any MCP client two economic-safety tools: realizable quote and pretrade check, paid per call in USDC with no accounts.
    2
    83 npm
    MIT

  • o1-mcp

    mannutech
    A
    license
    A
    quality
    D
    maintenance
    Provides access to live swap quotes and routing on the Base network via the o1.exchange DEX aggregator. Read-only and safe by default, it returns routing data and unsigned calldata for you to sign in your own wallet.
    3
    MIT