Stoa: swaps on Robinhood Chain

io.github.StoaDexPublished by GitHub account StoaDexv1.1.0Updated Nov 21, 2026

Swaps, token safety checks, stock-token gaps, Spotlight and Stoa Pay on Robinhood Chain.

The publisher's own server: Agent.chain.tokyo Address Contracts

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

Stoa's swap router MCP: quote, safety-check and build unsigned swaps on Robinhood Chain, bridge in, and read market context.

What you can do
  • List tokens and router addresses on a network, and quote the best route across venues with amountOut, minOut and price impact
  • Build an unsigned swap transaction plus any needed approval for the user's own wallet to sign
  • Simulate a buy and sell-back of a token and report a risk verdict, taxes, round-trip cost and holder concentration
  • Quote a bridge of ETH, USDC or USDT from Base, Arbitrum, Ethereum, Optimism or BNB Chain to Robinhood Chain
  • Read CoinMarketCap market context: total market cap, BTC/ETH prices and dominance, Fear and Greed, and per-token stats
  • Look up Robinhood Stock Tokens with underlying and on-chain prices, and read Stoa Spotlight weekly bid and vote status
When to use it
Useful when an assistant helps a user trade or evaluate tokens on Robinhood Chain or Elysium: comparing routes, screening a token before buying, preparing a wallet-signed swap, or moving funds onto Robinhood Chain. Also handy for quick market context and stock-token price comparisons.
Requirements
Remote streamable HTTP endpoint at stoadex.com; no package, environment variables or headers declared. The user needs a wallet on Robinhood Chain (chain 4663, gas ETH) or Elysium, and funds on a supported source chain for bridging.
Before you install
The server builds real transactions that move funds; the user's wallet signs and sends them, and selling a token requires an approval to approval.spender first. Quotes move, so rebuild right before sending. Token addresses should come from list_tokens or the project's own site, and unverified tokens should be safety-checked first. The contracts are stated as not audited yet, and market_context is data, not advice.

Installation

In SourceWeft

  1. Open Stoa: swaps on Robinhood Chain in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.StoaDex%2Fstoa/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "stoa-swaps-on-robinhood-chain": {
      "type": "http",
      "url": "https://stoadex.com/mcp"
    }
  }
}

README

[Stoa: every route, compared. Swaps on Robinhood Chain and Elysium]

stoadex.com · Docs · $STOA · X / @StoaDEX

[CI] [Solidity 0.8.28] [Foundry] [Next.js 15] [Verified on Sourcify] [Not audited yet] [Signed mirror on Twigpine]

[Stoa on HEY Research Lab]

#BuildwithCMC: the MCP server at stoadex.com/mcp now has a market_context tool built on the CoinMarketCap API. See hackathon/cmc.

Stoa

Stoa is a swap router with maker-quoted pools (PropAMM). Every swap is quoted against every venue the router knows on the network: Stoa maker pools, Uniswap V2, V3 and V4, Aero, Ramses and Liquidity Book. It fills where the trader gets the most, directly or through the wrapped native token. Stoa charges a flat 2 bps protocol fee, once per swap (a route through two Stoa maker pools pays each pool's fee; see Fees).

It is live on Elysium (chain 99901) and Robinhood Chain (chain 4663).

How a swap works

mermaid
flowchart LR    U([Trader]) -->|quote| R[StoaRouter]    R -->|asks every venue,<br/>direct and via WETH/WHYPE| V{{Stoa maker pools<br/>Uniswap V2 · V3 · V4<br/>Aero · Ramses · Liquidity Book}}    V -->|best route| R    U -->|swap with minOut| R    R -->|fill| V    R -->|output, measured| U    R -->|2 bps| F[FeeDistributor]    F -->|10%| Ref([Referrer])    F -->|protocol share,<br/>Robinhood Chain| B[StoaBuyback]    B -->|buy and burn| S(("$STOA"))
  • The router never trusts a venue. It measures what the trader actually receives and reverts below minOut (standard tokens; see K-1 in the security review for tokens that tax transfers). Venues are allowlisted adapters; new ones wait in public before they go live.
  • Maker pools are quoted every block by bonded makers. When no maker quotes, swaps still fill on the best outside venue.
  • Uniswap V4 pools are registered permissionlessly in Stoa's adapter, limited to hooks on an allowlist fixed at deployment.

Governance and security

ElysiumRobinhood Chain
Router0x1047…7dbA0x2F28…3eE5
Owner of every contract48h timelock 0xeBa0…417B48h timelock 0xAC75…3ed8
Proposer and executor2-of-3 Safe 0xBF71…055F2-of-3 Safe 0xa1a4…D386
  • No upgradeable code. No proxies; a fix is a new deployment.
  • Every owner action waits 48 hours in public, and a new venue waits another 24 hours in the router itself. A guardian wallet can only pause swaps.
  • Every contract is source-verified on Sourcify (exact match), so the code here is the code that runs.
  • Not audited yet. Maker pools cap each fill at $500 and public LP vaults stay closed until an external audit. Design guarantees, trusted roles and known limits: contracts/SECURITY.md.

Every address: docs/contracts, or web/lib/deployments.json (Elysium) and web/lib/deployments-4663.json (Robinhood Chain).

$STOA

0x13E6…6718 on Robinhood Chain, launched on Pons. Two jobs, both enforced by contracts:

  1. Buyback and burn. StoaBuyback owns the Robinhood Chain FeeDistributor. Protocol fees can only leave it as a swap into $STOA through the Stoa router, burned in the same transaction. A keeper runs it weekly.
  2. Maker bonds. Makers bond $STOA in BondRegistry to quote Stoa pools on Robinhood Chain. Slashed bonds are burned.

$STOA pays no fee share and no yield. Details: docs/token.

Repository

FolderWhatStack
contracts/Router, maker pools, venue adapters, fee distributor, buyback, bond registry; deploy and governance scripts; unit, attack and live fork testsSolidity 0.8.28, Foundry
web/stoadex.com: trade, pools, earn, curators, $STOA, referrals, portfolio, admin console, docsNext.js 15, wagmi, viem, three.js
web/content/docs/The documentation at stoadex.com/docsMarkdown (GitBook format)
maker/Maker bot: quotes a Stoa pool every block from the Hyperliquid order book, with risk limitsTypeScript, viem
.github/workflows/CI, deployments, monitoring and the scheduled jobs belowGitHub Actions

Development

Requirements: Foundry, Node 22.

bash
git clone --recurse-submodules <repo-url> && cd stoa
# contracts: build, unit and attack testscd contracts && forge build && forge test
# live fork tests (read-only, against mainnet state)ELYSIUM_RPC_URL=https://rpc.elysium.kinetiq.xyz forge test --match-contract "ForkElysium|ForkVenues"ROBINHOOD_RPC_URL=https://rpc.mainnet.chain.robinhood.com forge test --match-contract ForkRobinhood
# web appcd ../web && npm install && cp .env.example .env.local && npm run dev
# maker bot (dry run)cd ../maker && npm install && cp .env.example .env && npm run build && DRY_RUN=1 npm start

The contracts have 93 tests: 73 unit and attack tests (including fuzzing) and 20 fork tests that trade against live pools, run governance through the real Safe and timelock, and check every allowed Uniswap V4 hook with a real buy and sell.

Automation

WorkflowWhenWhat
CIevery pushforge fmt, build with sizes, unit and Elysium fork tests; web and maker tests
Health checkhourlysite up, router not paused and quoting, keeper gas
Refresh Uniswap V4 poolsdailyranks the most traded V4 pools and registers new ones on both chains
$STOA graduation watcherevery 10 minregisters $STOA's Uniswap V4 pool as soon as it leaves the Pons curve
Robinhood governance stepshourly while pendingmoves timelocked Safe actions forward when they are due
$STOA buyback & burnweeklyturns Robinhood Chain protocol fees into burned $STOA
Deploy / smoke swapmanualdry run first, then broadcast; real swap round trip on mainnet

Security

Please report vulnerabilities privately: see SECURITY.md. Do not open a public issue for them.

License

The smart contracts in contracts/src are MIT licensed (contracts/LICENSE), as their SPDX headers state. The web app, maker bot, docs and brand assets are © Stoa, all rights reserved.

Source: README.md at commit b061253

Tools

13

list_tokens

List tokens

Tokens Stoa lists on a network, with address, symbol and decimals, plus the router address. Any other token address can still be quoted, but treat it as unverified and run safety_check first.

Parameterschain

quote

Quote a swap

Compare every venue Stoa routes for this exact amount and return the route it would fill: amountOut (after Stoa's 2 bps fee), minOut for the slippage, price impact and the venues. Read-only.

ParameterschainamountrequiredbuyTokenrequiredsellTokenrequiredslippageBps

build_swap

Build an unsigned swap

Same as quote, plus the unsigned transaction (to, data, value, chainId) for the taker's wallet to sign, and the approval it needs first when selling a token. Stoa never signs or sends anything.

ParameterschaintakerrequiredamountrequiredbuyTokenrequiredreferrersellTokenrequiredslippageBpsdeadlineSeconds

safety_check

Token safety check

Simulate a small buy and an immediate sell-back of a token through Stoa's live router (eth_call, nothing sent), and read how concentrated its supply is. Returns verdict ok | caution | danger | unknown, buy and sell tax, round-trip cost, creator and top-10 holdings. A pass describes the token today; its owner can still change the rules.

Parameterschaintokenrequired

bridge_quote

Bridge to Robinhood Chain

Move ETH, USDC or USDT from Base, Arbitrum, Ethereum, Optimism or BNB Chain to the same wallet on Robinhood Chain (arriving as ETH or USDG), through LI.FI over Across. Returns an unsigned transaction on the source chain that Stoa has already decoded: receiver and refund address are the wallet, destination is Robinhood Chain, it spends exactly the amount asked. If 'approval' is present, approve exactly that amount first. Regular wallets only.

ParametersamountrequiredwalletrequiredtoTokenfromChainrequiredfromTokenrequired

market_context

Market context (CoinMarketCap)

CoinMarketCap data to put a trade in context: total crypto market cap and 24h change, BTC and ETH prices and dominance, the Fear and Greed index, and for up to 5 Robinhood Chain tokens their price, market cap, liquidity, 24h high/low, volume, trades, buyers and sellers. Use it before suggesting or explaining a trade; use quote for the price a swap actually gets.

Parameterstokens

stock_tokens

Robinhood stock tokens

Robinhood Stock Tokens on Robinhood Chain: Robinhood's price for the underlying stock next to the on-chain price, liquidity, 24h volume and whether Stoa can route a swap. Optionally filter by ticker.

ParameterssymbolroutableOnly

stock_gaps

Stock token price gaps

Robinhood Stock Tokens whose on-chain price is furthest from Robinhood's own price right now: cheaper or dearer on-chain, among pools with real liquidity that actually trade (pools with under $100 of 24h volume and gaps over 25% are left out as stale). Optionally a 7-day history of one token's gap from Stoa's open dataset. Information, not trading advice; outside US market hours Robinhood's price follows the overnight session.

ParameterssidelimithistoryForminLiquidityUsd

open_data

Stoa open data

Stoa's public on-chain data: every swap routed through Stoa (newest first), the Points season 1 board, or the venue-quote basket (the same swaps quoted on every Robinhood Chain venue in one block). Also lists the open datasets on Hugging Face with their download links and checksums.

Parameterssetlimit

spotlight

Spotlight this week

Stoa Spotlight on Robinhood Chain: projects bid ETH for 3 sponsored slots a week and $STOA holders lock and vote; voters share most of each winning bid. Returns the week, its phase (before_week_1, bids_open, votes_only) and closing times, the rules (quorum, min bid, entry fee), every candidate with its bid, votes, whether it wins if voting closed now, the votes it still needs and the ETH per 1M votes it would pay now, last week's winners and the $STOA locked. Give `token` and `votes` to estimate what that many more votes on that token would earn if it wins (an estimate: bids and votes move until the week closes). Sponsored, not reviewed: run safety_check before buying a Spotlight token.

Parameterstokenvotes

payment_status

Is a Stoa Pay link paid?

Whether a Stoa Pay link has been paid on Robinhood Chain, read from the chain: the paying transaction, who paid and when.

Parametersurlrequired

Version history

2
  1. v1.1.0LatestNov 21, 2026
  2. v1.0.0Nov 19, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Chain integrations