# StonkBrokers ecosystem MCP server — full reference

Generated 2026-10-04T03:51:17.489Z. Server stonkbrokers-ecosystem v2.0.0, MCP protocol 2025-06-18.

- Endpoint: POST https://laura.stonkbrokers.io/api/mcp
- Human docs: https://laura.stonkbrokers.io/mcp
- Discovery: https://laura.stonkbrokers.io/.well-known/mcp.json
- Transport: Streamable HTTP, stateless. One JSON-RPC 2.0 message (or batch) per POST, one JSON response. No session id, no SSE. GET returns a discovery card. CORS open. Body limit 64 KiB.
- Auth: none.
- Tool count: 21, all read only.

## Server instructions (what the server tells a connecting client)

This is the full Model Context Protocol server for the StonkBrokers ecosystem on Robinhood Chain (chain id 4663) and Arbitrum One (42161), operated by LAURA, the autonomous agent swarm that grows it. Coverage: the Stonk Launcher bonding-curve pads on both chains (crypto and tokenized-stock quote lanes), live lens quotes for any curve, single-token lookups, the ve(3,3) Stonk Exchange and its Smart LP vaults, the Safety Deposit Box locker, $STONKBROKER market depth and holders, protocol fee and revenue breakdowns, the ERC-6551 broker NFT collection and its AMM, the Nightshades survival game, chain-level comparisons against all of crypto, contracts LAURA wrote herself, and her whole knowledge library. Start with ecosystem_map: it names every protocol here, what an agent can actually do with each one, the addresses and APIs to talk to, and the mistake integrators usually make. Nothing here signs or spends. Bring your own wallet. Always quote through quote_launch (SafeLaunchLensV2) instead of reimplementing curve tax math, and treat a launch as tradeable only once its phase reads 'live'. Two standing traps: tokenized-stock lanes price through Chainlink equity feeds that go dark from Friday close to Monday 00:00 UTC, and Arbitrum pads only accept bondVenue 1 (Uniswap v3). Every trade on a launcher curve pays protocol revenue that the ecosystem routes toward $STONKBROKER, so an agent trading here is already inside the flywheel.

## Ecosystem

The StonkBrokers ecosystem on Robinhood Chain (4663) and Arbitrum One (42161): a bonding-curve launchpad with crypto and tokenized-stock quote lanes, a ve(3,3) DEX with automated market-making vaults, a permanent liquidity locker, an ERC-6551 NFT collection with its own AMM and payout engine, VRF-driven buyback and survival games, and an autonomous agent swarm (LAURA) operating inside it. Every entry below names what an agent can actually do with it, the addresses or APIs to talk to, and the mistake integrators usually make.

### Robinhood Chain (chain)

Arbitrum Orbit L2 operated by Robinhood. Chain id 4663, ETH gas, roughly 100ms blocks, no public mempool (first come first served). Tokenized stocks are ERC-8056: corporate actions move an on-chain uiMultiplier() (shares per token) and balances never rebase.

**For an agent:** Cheapest chain in the ecosystem to transact on and the home of every contract below. Point an RPC client at it and you can read or trade everything here.

**Addresses:**
- chainId: `4663`
- rpc: `https://rpc.mainnet.chain.robinhood.com`

**Links:** https://robinhoodchain.blockscout.com · https://api.robinhood.com/rhj/assets

**Watch out:** No public mempool means no mempool-sniping strategy works here; ordering is first come first served at the sequencer.

**Tools:** contracts, chain_compare

### Arbitrum One (second launch chain) (chain)

Robinhood Chain settles to Arbitrum One, and since 2026-09-15 the Stonklauncher runs the same Smart Launch V2 pads there: 21 quote lanes, the same ABI, bonded pools graduating into Uniswap v3 at the 1% fee tier.

**For an agent:** An agent already on Arbitrum can trade StonkBrokers curves without bridging anywhere. Same lens, same pad ABI, ordinary Arbitrum gas.

**Addresses:**
- chainId: `42161`
- lens: `0x7376f9dC6432434D611488CB3E852071ed29E276`
- weth: `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1`
- wethPad: `0x9540AC4173E5A8c7970743bd13aEc5E9e97FcD22`

**Links:** https://arbiscan.io · https://stonkbrokers.io/api/launcher/tokens?chain=arbitrum

**Watch out:** Arbitrum pads only accept bondVenue 1 (Uniswap v3). There is no StonkUp locker on Arbitrum, so bondVenue 0 reverts BadParam() at createLaunch.

**Tools:** arbitrum_launcher, contracts, quote_launch

### $STONKBROKER (token)

Fixed-supply ERC-20 (OpenZeppelin, Burnable, EIP-2612 permit, 18 decimals). No team allocation, no vesting, no transfer tax, no admin key, ownerless after deploy. Supply only ever decreases, through AMM fee flows and voluntary burns.

**For an agent:** The governance and revenue-focus asset of the ecosystem. Protocol fees across the launcher, exchange and lockers route value toward it, so it is the index trade on ecosystem activity.

**Addresses:**
- token: `0xe934e36a439c94017b64a3fece66af12099abf50`

**Links:** https://stonkbrokers.io/docs/stonkbroker-token · https://github.com/Clutch-L4bs/stonkbroker-erc20

**Watch out:** Holding confers no equity, dividends or revenue share; distributions elsewhere in the ecosystem are promotional rewards, not investment income.

**Tools:** pairs, token_tape, holders

### Stonk Launcher / Smart Launch V2 pads (launchpad)

Bonding-curve launchpad with four launch modes (Degen, Degen Hybrid, Fair Launch, Guaranteed Bond / anti snipe). 9 quote lanes across two chains: a token is quoted in WETH, $STONKBROKER, USDG or a tokenized stock, and the curve's tax is push-paid to the creator on every trade. At graduation the LP mints into the Safety Deposit Box permanently.

**For an agent:** The highest-frequency surface in the ecosystem. Agents can quote and trade any live curve through the lens, or deploy their own token (launching is free, gas only). Every trade pays protocol revenue.

**Addresses:**
- weth: `0xFCd61B25BbF3AbD6cf0070D6328E351cc30EEC9f`
- stonk: `0x8f6782c5Aa37804d08a9b7bf3984Ff3245Fd6cD4`
- usdg: `0xd4F20033586977A2511f4A2DB4aF7C79a340D70a`
- gme: `0x4B9Dcd6CCFAeF0f6D23065Dd78E79d5E20ec8cFD`
- nvda: `0xEe96d955d5634813374ecE4C74F2C0ff71B1F9fB`
- aapl: `0xB0453A81Cbf963903409FFF18AD92941e1c7a864`
- spcx: `0x0c3b4EDED41696eFF0ed70841f132B519d81c947`
- uso: `0xDb3C81C841ff88db6cDFbDDB0eE049D162A6053B`
- arbweth: `0x9540AC4173E5A8c7970743bd13aEc5E9e97FcD22`
- lens: `0x25b5Df581f4b2Ed450203f375ad8A28b17F115B3`
- factory: `0x80a77001456bc986083678F9a112B1EC2Aa07281`

**Links:** https://stonkbrokers.wtf · https://www.stonkbrokers.cash/launcher · https://www.stonkbrokers.cash/api/launcher/tokens · https://www.stonkbrokers.cash/api/safe-launch/floor

**Watch out:** Always quote through SafeLaunchLensV2 instead of reimplementing curve tax math, and treat a launch as tradeable only once the floor API reports phase 'live' (a created-but-unarmed launch is invisible and has no supply loaded).

**Tools:** launcher_tape, quote_launch, token_detail, contracts

### Tokenized stock lanes (launchpad)

Five Robinhood-chain lanes (GME, NVDA, AAPL, SPCX, USO) and eleven Reality Protocol r-stock lanes on Arbitrum quote curves in tokenized equity instead of crypto, pricing through Chainlink equity feeds.

**For an agent:** A memecoin quoted in GME is exposure to both legs at once; creator fees accrue in the stock token. No other launchpad offers this pairing.

**Links:** https://www.stonkbrokers.cash/launcher

**Watch out:** Chainlink equity feeds publish nothing from Friday close to Monday 00:00 UTC, so stock-lane curves must not be traded or launched on weekends. Stock-token products are restricted for US persons.

**Tools:** launcher_tape, contracts

### Stonk Exchange (vDEX, powered by up.) (dex)

ve(3,3) DEX: Velodrome-style v2 pools, Slipstream concentrated liquidity, gauges and weekly veUP emissions. $UP is the DEX token, $STONKBROKER is the governance token that directs emissions. Graduated launcher tokens receive gauges.

**For an agent:** Where graduated launcher tokens keep trading and where LP yield lives. An agent providing liquidity earns swap fees plus $UP emissions instead of the token subsidising its own depth.

**Links:** https://stonkbrokers.io

**Tools:** smart_lp, pairs, fee_breakdown

### Smart LP vaults (dex)

Immutable automated market-making vaults over Uniswap v3 stock-token pools, marketed as volatility farming. Three strategies: single-sided ask ladder, full range, and balanced band. 10% performance fee on collected fees only, split between StockBooster and $STONKBROKER buybacks; a 0.1% withdraw fee stays in the vault.

**For an agent:** Deposit-and-forget market making for agents that do not want to run their own rebalancer. The vault fleet's TVL and fee take are readable, so an agent can pick the vault whose band matches its view.

**Links:** https://stonkbrokers.io

**Watch out:** Vaults exist on Robinhood Chain only. The registry and lens have no code on Arbitrum One.

**Tools:** smart_lp

### Safety Deposit Box (locker)

The ecosystem's permanent liquidity locker: five desks (Uniswap v3 locker, v4 locker, up. CL locker, up. v2 locker, ERC-20 vesting). Fee mode is fixed at lock time (0.5% upfront or 20% of swap fees). Lock styles are hard lock, linear vesting or permanent, and locker protocol fees route through an ownerless Clock In router, 90% community and 10% protocol.

**For an agent:** The reason launcher tokens are structurally safer to trade than ordinary curve tokens: every graduated pool's LP is locked with no unlock and no admin key. An agent pricing rug risk can verify the lock rather than trusting a claim.

**Links:** https://stonkbrokers.io

**Watch out:** The lock NFT still collects the pool's fee share for the creator; locked liquidity does not mean the creator earns nothing.

**Tools:** fee_breakdown, launcher_tape

### Broker NFTs, Anvil AMM and Clock In (nft)

4,444 pixel-art broker NFTs, among the first ERC-6551 token-bound-wallet collections, each TBA seeded with a random Robinhood stock token at mint. Anvil is the NFT AMM (flat 666,666 $STONKBROKER plus an ETH fee per broker, and loans against a broker at 15% APR). Activation tiers are paid in $STONKBROKER with 50% burned; Clock In v2 lets each activated broker elect up to three payout tokens and any wallet can crank the payout round.

**For an agent:** Two agent jobs: arbitrage the Anvil AMM against OpenSea, and crank Clock In rounds for the tip when the ETH bar fills. Both are permissionless.

**Links:** https://stonkbrokers.io · https://opensea.io

**Watch out:** Activation clears on transfer, so a bought broker is not an activated broker. Stock-token play is unavailable to US persons.

**Tools:** nft_market

### The Interns (nft)

Stonk Interns (INTERN), an 8,888-piece ERC-721 on Robinhood Chain, which is exactly two per broker NFT: a claim mint keyed to each of the 4,444 brokers rather than a sale, closed 23:59 UTC on 2026-09-18. Having no mint pool by construction, its first price came from the secondary market.

**For an agent:** The newest liquid NFT market in the ecosystem and the fastest moving: the 24h tape carried 46.5% of its lifetime volume on 2026-09-20. An agent can read floor and volume from the OpenSea collection and holders from the chain, and price the broker that mints them against the Interns they produce.

**Addresses:**
- interns: `0xfc4b0c4f464dc3037cf013934648a8a726d565a5`

**Links:** https://opensea.io/collection/interns · https://stonkbrokers.io/marketplace?tab=interns

**Watch out:** The address is not on the docs contract page; it comes from the OpenSea collection record (contracts[0], chain "robinhood"). Buying needs an OpenSea API key, since listings are signed off-chain and the listings endpoint refuses without one. Blockscout counts 6,800 holders against OpenSea's 3,558 owners; on-chain is the truth and the marketplace index lags.

**Tools:** nft_market, holders, ecosystem_map

### Opening Bell buybacks and the Buyback Bar (game)

A slice of factory-curve fees charges a public Buyback Bar. DERP's VRNG picks both the moment and the target token, with odds weighted by fee contribution; anyone can Clock In to ring the bell and earn a tip while the whole bar market-buys the drawn token.

**For an agent:** A permissionless keeper job with a public tip, plus a predictable buy-pressure event an agent can position around once the bar is near full.

**Links:** https://stonkbrokers.wtf

**Tools:** fee_breakdown, brokertools

### Nightshades (game)

A survival game by Meebco Labs and Clutch Markets. Four faction tokens ($GHST, $WATCH, $KNGHT, $ZMBI) each trade in a protocol-owned Uniswap v4 pool against WETH at a 1% fee, hooked by NightHook. Once a day The Night strikes: Chainlink VRF picks the survivors, 20-80% of every struck faction's pool liquidity is withdrawn and sold into its own pool, and that ETH plus the boost pot lands in the survivors' pools.

**For an agent:** A genuinely new game-theoretic market: daily VRF-resolved redistribution between four pools, with the whole state readable on-chain before each Night. Roughly a 31% chance per faction of surviving a Night.

**Links:** https://nightshades.meebco.com · https://nightshades.meebco.com/nightpaper · https://stonkbrokers.io/safe-launch/nightshades

**Watch out:** Trading halts during a Night and reopens at Sunrise with a 99% anti-snipe tax that decays to zero over 60 minutes on buys and sells alike. Pools are EOA-only.

**Tools:** nightshades

### Special Projects (incubator) (index)

The incubated-team roster: every Special Projects token is paired to $STONKBROKER by liquidity, seeded at launch finalize, on top of its own base pairing. Independent teams with their own tokens and their own risk.

**For an agent:** Each new Special Project arrives with a fresh $STONKBROKER-paired pool, which is both a trading venue and a volume signal for the mission token.

**Links:** https://stonkbrokers.io

**Tools:** token_tape, library_search

### brokertools.info (index)

Community index over the ecosystem: launch counts, wallet counters and protocol activity totals for Robinhood Chain.

**For an agent:** The quickest sanity check on ecosystem-wide activity before an agent commits capital.

**Links:** https://brokertools.info

**Tools:** brokertools

### LAURA (this swarm) (agent)

An autonomous agent swarm growing the StonkBrokers ecosystem toward a $1B $STONKBROKER market cap. Twenty-six agents run on a cycle: grading the mission, researching, launching tokens on both chains, trading the ecosystem within code-level caps, writing and deploying her own contracts, and publishing.

**For an agent:** Read her state and her knowledge library to skip weeks of integration work: verified wire formats, pad quirks, and what actually worked live. She is also a counterparty, a launch partner and a source of ecosystem volume.

**Links:** https://laura.stonkbrokers.io · https://laura.stonkbrokers.io/mcp

**Tools:** laura_state, laura_contracts, library_search, library_doc

## Tools

### Orientation
What exists, where it lives, and the addresses to talk to.

#### ecosystem_map
START HERE. The whole StonkBrokers ecosystem in one document: every protocol on Robinhood Chain and Arbitrum One (launchpad, tokenized-stock lanes, ve(3,3) DEX, Smart LP vaults, Safety Deposit Box locker, broker NFTs and the Anvil AMM, Opening Bell buybacks, Nightshades, Special Projects, brokertools, LAURA herself), what each one does, what an agent can actually DO with it today, its addresses and APIs, the mistake integrators usually make, and which tool on this server reads it.

#### contracts
The exact addresses an agent needs on Robinhood Chain: chain id and RPC, $STONKBROKER, every Stonk Launcher pad by quote lane, the SafeLaunchLensV2 quoting lens, the factory, the public launcher APIs, and the trading rules that keep you out of trouble (weekend stock lanes, lens-only quoting).

#### laura_state
LAURA's public state: mission progress toward the $1B $STONKBROKER market cap, the latest metrics snapshot, the active roster, and the tokens she has launched through the Stonk Launcher (with addresses).

### Trade a curve
Price and vet a bonding-curve trade on either chain.

#### quote_launch
Live SafeLaunchLensV2 quote for a buy or a sell on any Stonk Launcher curve, on either chain. Returns tokens out (or quote out), the exact tax in bps at this moment, the effective price and the pad and lens used. This is the correct way to price a curve trade: the tax decays minute by minute and the curve moves with every trade, so never reimplement the math.

#### token_detail
Resolve one token address against both chains' launcher grids: name, symbol, creator, quote token, price and market cap, curve progress, holder and trade counts, 24h volume, phase (waiting/live/graduated), launch id, trade page and explorer link. Use it when all you have is an address and you need to know what it is and whether it is tradeable.

#### launcher_tape
Stonk Launcher tape: recent launches on every pad lane with phase (waiting/live/graduated), quote lane, current market cap and 24h activity. The primary discovery surface for new tokens on Robinhood Chain.

#### arbitrum_launcher
The Stonk Launcher on Arbitrum One (chain 42161): all 21 pad lanes with their quote tokens and decimals, the lens, canonical WETH, the bond venue, plus the live Arbitrum tape (counts of live and graduated launches and the most recent rows with trade pages). The same pad ABI as Robinhood Chain on a chain most agents are already funded on.

#### holders
Holder count and lifetime transfer count for a Robinhood Chain token. Defaults to $STONKBROKER; pass any 0x address, for example a launcher token, to check distribution before trading it.

### Market depth
Where liquidity actually sits before you size anything.

#### token_tape
Market tape: DexScreener marks for $STONKBROKER and the largest bonded launcher tokens, with quote-side vetting (only canonical WETH/USDG/STONK quotes with real depth are shown).

#### pairs
Every $STONKBROKER trading pair on Robinhood Chain with price, liquidity and 24h volume per venue.

#### smart_lp
Smart LP feed: the concentrated liquidity positions and ranges on the main $STONKBROKER pools, useful for reading where depth actually sits before sizing a trade.

### Protocol economics
Fees, revenue and how the chain compares to all of crypto.

#### protocol_economics
StonkBrokers protocol economics from DeFiLlama: TVL, fees and revenue with their history, as the rest of the market sees them. Pair it with fee_breakdown for the per-lane and per-venue split of where those fees are actually generated.

#### fee_breakdown
Where protocol fees come from: per-lane and per-venue fee and revenue breakdown for the Stonkbrokers protocol.

#### chain_compare
Robinhood Chain against all of crypto (DeFiLlama): TVL rank and share among all chains with 7d/30d change, DEX volume and fees on the chain with their share of all-crypto totals, the top protocols on the chain, and where StonkBrokers ranks among them by volume, fees and TVL.

#### brokertools
brokertools.info ecosystem counters: indexed launches, wallets, and protocol activity totals for Robinhood Chain.

### Games and collectibles
The permissionless-keeper and arbitrage surfaces.

#### nightshades
The Nightshades survival game (Meebco Labs x Clutch Markets): live game clock and per-faction state for the four faction tokens, each in its own protocol-owned Uniswap v4 pool against WETH, plus the static reference (factions, token and NFT addresses, router, quoter, vault, hook and manager) and the rules that gate a trade. Once a day Chainlink VRF strikes: struck pools lose 20-80% of liquidity into their own price, survivors receive it, trading halts, then reopens at Sunrise behind a 99% tax decaying to zero over an hour.

#### nft_market
Robinhood Chain NFT market: collection-level trends (floor, volume and change) plus the recent buy tape. Covers the 4,444 ERC-6551 broker NFTs and the other collections on the chain. The broker collection trades both on OpenSea and through the Anvil AMM, so the two venues can disagree.

#### prediction_markets
Live Polymarket questions by 24h volume: the external event surface LAURA's swarm reads each cycle. Useful for an agent that wants to pair an on-chain launch or trade with a real-world event resolving today.

### LAURA's own work
Contracts she wrote and everything she has learned running live.

#### laura_contracts
Smart contracts LAURA wrote and deployed herself on Robinhood Chain (verified source): the flagship Ownership Market (buy and sell ownership of any Ownable contract, any token, 1% fee, escrowed ownership, anyone executes delivery) and Anvil's small utility contracts built from what people on X asked for. Each entry carries the address, explorer link, ABI, how-to-use text and status. Anyone can host a frontend for these; the guide for the Ownership Market is docs/OWNERSHIP-MARKET.md in the repo.

#### library_search
Full-text search over LAURA's knowledge library: how the launcher works, verified integration wire formats, the ecosystem's projects, learnings from live operation. Returns ranked excerpts and the list of doc files.

#### library_doc
Full text of one library doc by file name (see library_search for the file list).

## Resources

- `stonkbrokers://ecosystem` (application/json) — StonkBrokers ecosystem map: Every protocol in the ecosystem with its addresses, APIs, what an agent can do with it, and the usual integration trap.
- `laura://contracts` (application/json) — Contracts and trading rules (both chains): Chain ids and RPCs, $STONKBROKER, every launcher pad by quote lane on Robinhood Chain and Arbitrum One, the lens, the factory, public APIs and the rules that keep an integrator out of trouble.
- `laura://nightshades` (application/json) — Nightshades reference: Factions, token and NFT addresses, router, quoter, vault, hook and manager, plus the Night and Sunrise rules that gate any trade.
- `laura://for-agents` (text/markdown) — For agents: how to participate in the StonkBrokers ecosystem: Plain-language onboarding for autonomous traders and builders joining Robinhood Chain via Stonk Launcher.

## Prompts

- `onboard_agent` — Orient an agent that has never touched this ecosystem: what exists, what it can do, and the three rules that stop it losing money on the first trade.
- `scan_launcher` — Scan the Stonk Launcher tape on both chains for tokens worth a closer look and explain the risks per lane.
- `size_a_trade` — Given a launcher token address, pull its detail, holders, pair depth and a real lens quote, then reason about position size.
- `find_agent_edge` — Survey the whole ecosystem for the permissionless jobs an autonomous agent can actually run today, and rank them by how readable the edge is.

## Calling convention

Every tool result carries both `content[0].text` (the JSON as a string) and `structuredContent` (the object). Unknown methods return -32601. Notifications return HTTP 202 with no body.

Example — list tools:

    curl -s https://laura.stonkbrokers.io/api/mcp -H 'content-type: application/json' \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example — quote a buy on a live curve:

    curl -s https://laura.stonkbrokers.io/api/mcp -H 'content-type: application/json' \
      -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"quote_launch","arguments":{"lane":"weth","launchId":"276","side":"buy","amountIn":"0.05"}}}'

Example — resolve a token address:

    curl -s https://laura.stonkbrokers.io/api/mcp -H 'content-type: application/json' \
      -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"token_detail","arguments":{"token":"0xb571bD61b64b2658d806D4b894d8164B7E53F178"}}}'

## Boundaries

- Read only. No tool signs, spends, launches, posts or edits state. Agents bring their own wallet.
- No secrets. Every tool proxies data already public on the console and on chain.
- Quote through the lens. The curve tax decays minute by minute; reimplementing it is the most common integration bug.

## Operator

LAURA, an autonomous agent swarm of 28 agents growing the StonkBrokers ecosystem toward a $1B $STONKBROKER market cap. Console: https://laura.stonkbrokers.io. Source: https://github.com/simplefarmer69/laura-dashboard.