StonkBroker AI

Ownerless trading contracts and an MCP server built for AI agents on Robinhood Chain.

Developers

Overview

Lowest fee rails for agents

Every contract is ownerless and its fees are fixed in bytecode. Agents pay a 1 bp protocol fee on the router and launchpad, routed to the StonkBroker AI Buyback Burn, which buys and burns $STONKBROKER. The suite includes a Uniswap v3 fork with fee tiers down to 0.0001%.

  • Router across the AI fork and canonical Uniswap v3, multi hop, ETH in and out
  • Lens with batch quotes and machine readable reason codes
  • Launchpad with anti snipe tax, bond into a locked LP and referral fees
  • Verified on Sourcify with an exact match

Fees

Integrator fee hook

Every user action takes an Integrator struct. A front end, bot or agent platform sets its own wallet and up to 250 bps. The fee is charged on top of the input and sent to feeTo in the same transaction, so builders earn on every order they route with no registration.

LegAmountRecipient
Protocol fee1 bpStonkBroker AI: Buyback Burn
Integrator fee0 to 250 bps, set per callYour feeTo wallet
Fork LP protocol share1/10 of LP feesStonkBroker AI: Buyback Burn
Fork fee tiers0.0001% 0.0005% 0.001% 0.005% 0.01% 0.05% 0.3% 1%Liquidity providers

MCP

MCP server

The server runs over stdio and needs Node 22.12 or newer. With no key it is read only and returns unsigned transactions. Set AGENT_PRIVATE_KEY in the agent host environment to enable execute.

json
{
  "mcpServers": {
    "stonkbroker-ai": {
      "command": "npx",
      "args": ["-y", "@stonkbrokers/agent-mcp"],
      "env": {
        "RPC_URL": "https://rpc.mainnet.chain.robinhood.com",
        "AGENT_MAX_VALUE_WEI": "100000000000000000"
      }
    }
  }
}
ToolWhat it does
suite_infoAddresses, fees and venues
directoryRead the onchain Directory
quote / quote_batchRouter and Lens quotes with reason codes
pool_depth / route_healthDepth and health checks before sizing
feed_statusChainlink feed freshness
balancesERC20 and ETH balances for any wallet
launch_infoLaunchpad state, mcap and quotes
build_swap / build_approveUnsigned transactions for the router
build_launch_create / buy / sellUnsigned launchpad transactions
simulateeth_call any built transaction
executeSign and send, only when AGENT_PRIVATE_KEY is set, capped by AGENT_MAX_VALUE_WEI

Contracts

Router interface

solidity
struct Hop { uint8 venue; uint24 fee; address tokenOut; }   // venue 0 = AI fork, 1 = Uniswap v3
struct Integrator { address feeTo; uint16 feeBps; bytes32 ref; } // feeBps <= 250, charged on top of input

function quoteExactIn(address tokenIn, uint256 amountIn, Hop[] hops) returns (uint256 amountOut);

function swapExactIn(
  address tokenIn, uint256 amountIn, Hop[] hops,
  uint256 minOut, address recipient, uint256 deadline,
  bool unwrapOut, Integrator integrator
) payable returns (uint256 amountOut);

Quote with viem

ts
import { createPublicClient, http, parseEther } from "viem";
import routerAbi from "./StonkBrokerAIRouter.abi.json";

const ROUTER = "0x003B266B70Ac750e9cf23c4002CE216626E2f95a";
const WETH = "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73";
const STONK = "0xe934e36A439C94017B64a3FecE66AF12099aBF50";

const client = createPublicClient({ transport: http("https://rpc.mainnet.chain.robinhood.com") });
const hops = [{ venue: 0, fee: 10000, tokenOut: STONK }];
const amountOut = await client.readContract({
  address: ROUTER, abi: routerAbi, functionName: "quoteExactIn",
  args: [WETH, parseEther("0.01"), hops],
});
// Your front end earns 0.5% on top of every swap it sends:
const integrator = { feeTo: "0xYourFeeWallet", feeBps: 50, ref: "0x" + "00".repeat(32) };

Lens

Reason codes

CodeNameMeaning
0OKRoute quoted and healthy
1NO_POOLNo pool for this pair and fee tier
2BAD_ROUTEHops do not connect or venue is unknown
3THIN_POOLQuote side depth under the requested minimum
4QUOTE_FAILEDThe venue quoter reverted
5ZERO_AMOUNTInput amount is zero
6FEED_STALEPrice feed older than its max age
7FEED_INVALIDPrice feed answered zero or negative
8TOKEN_PAUSEDToken transfers are paused by its issuer
9FEE_TOO_HIGHIntegrator fee above 250 bps
10GAS_OVER_CEILINGEstimated gas above the requested ceiling

Addresses

Robinhood Chain 4663

Suite
ContractAddress
StonkBroker AI: Directory0x5A79…16BF0x5A798EFed58DB4E732fEf50315e0393b720E16BF
StonkBroker AI: Router0x003B…f95a0x003B266B70Ac750e9cf23c4002CE216626E2f95a
StonkBroker AI: Lens0xAd61…35040xAd6163CB3292a69c2D81f4Fbd5D6e7aCbD533504
StonkBroker AI: Launchpad0xbB30…5FC00xbB303Ecb31d53e87cD99c98c63fB5e81C5e55FC0
StonkBroker AI: LP Locker0xA8E0…040C0xA8E00Ef659E6B727b8A1b1c58DB99B6121fD040C
StonkBroker AI: Liquidity Vault0x1a8d…e26e0x1a8dFEAe3c1382D1F0D7195a70edF1bDF39Ce26e
StonkBroker AI: Buyback Burn0x041D…3dC50x041Db4686Ab865747D7e70a57bd5af01350f3dC5
StonkBroker AI v3 fork
ContractAddress
StonkBroker AI: Factory0x22F0…E70C0x22F0917A6e8A14b127C4bE7d89aD172a3d8DE70C
StonkBroker AI: Fee Controller0x2828…b8CD0x28287F8D04a375fdf51bb2628a6c39111504b8CD
StonkBroker AI: Position Manager0xeAc7…10870xeAc77d5F8a06a780c811af960677665ca8561087
StonkBroker AI: Swap Router0x1284…0ff30x12847F5934A559AF31aC0102092899c5E1670ff3
StonkBroker AI: Quoter0xa7b8…a3550xa7b854B3f780D7aB40474488ad823a3Faf27a355
Tokens
ContractAddress
WETH0x0Bd7…AD730x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73
STONKBROKER0xe934…BF500xe934e36A439C94017B64a3FecE66AF12099aBF50
USDG0x5fc5…d1680x5fc5360D0400a0Fd4f2af552ADD042D716F1d168

Downloads

ABIs and deployments