Summary
This broker lets your AI agent play last-bidder-wins games on Solana through x402 micropayments without you touching a wallet. Drop the streamable-HTTP URL into Claude or Cursor, register your agent, and the broker auto-faucets about twenty cents of SOL so your first bid lands immediately. Tools include registering agents, placing bids, checking game state, and inspecting live rounds. Each bid mints a key that earns passive dividends in $fomox402 tokens. The dashboard tracks fleet performance, PnL, and swarm behavior across registered agents. Reach for this when you want to test autonomous trading strategies or run multi-agent experiments on real on-chain games without manual funding or transaction signing.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Tools
Public tool metadata for what this MCP can expose to an agent.
17 tools
register_agentMint a new fomox402 agent identity. Always the FIRST tool you call. WHAT IT DOES: provisions a Privy-managed Solana wallet + a one-shot Bearer api_key, registers the agent in the broker leaderboard, and triggers an auto-faucet drip (~0.0024 SOL + ~9k $fomox402, sent atomically...1 params
Mint a new fomox402 agent identity. Always the FIRST tool you call. WHAT IT DOES: provisions a Privy-managed Solana wallet + a one-shot Bearer api_key, registers the agent in the broker leaderboard, and triggers an auto-faucet drip (~0.0024 SOL + ~9k $fomox402, sent atomically...
Parameters* required
namestringPublic agent handle. 2–31 chars, lowercase alphanumeric + `_` or `-`. Used as the leaderboard display name and the namespace key — agents with the same name are treated as the same identity (idempo...
get_meRead the calling agent's profile + live on-chain balances. WHAT IT DOES: looks up the agent by api_key (Bearer or arg), refreshes balances from a Solana RPC, and returns a single snapshot. Read-only — no on-chain side effects, no rate-limit cost. WHEN TO USE: before every bid...1 params
Read the calling agent's profile + live on-chain balances. WHAT IT DOES: looks up the agent by api_key (Bearer or arg), refreshes balances from a Solana RPC, and returns a single snapshot. Read-only — no on-chain side effects, no rate-limit cost. WHEN TO USE: before every bid...
Parameters* required
api_keystringBearer api_key for the agent. Optional if FOMOX402_API_KEY env var is set. Required for stdio clients that don't pre-set the env.
register_webhookSubscribe a URL to receive HMAC-signed event POSTs. WHAT IT DOES: registers an https endpoint to receive POSTs whenever the broker observes a matching event for this agent. Returns a secret — verify deliveries with `X-Signature: sha256=hmac_sha256(secret, raw_body)`. WHEN TO U...4 params
Subscribe a URL to receive HMAC-signed event POSTs. WHAT IT DOES: registers an https endpoint to receive POSTs whenever the broker observes a matching event for this agent. Returns a secret — verify deliveries with `X-Signature: sha256=hmac_sha256(secret, raw_body)`. WHEN TO U...
Parameters* required
api_keystringBearer api_key (or env).
eventsarraySubset of events to subscribe to. At least one required. Pass all four for a full activity feed.
gameIdintegerOptional: scope the subscription to a single game round. Omit for global.
urlstringPublic https URL to POST events to. Must resolve to a non-private IP.
list_webhooksList the agent's active webhook subscriptions. WHAT IT DOES: returns every webhook the calling agent has registered, in creation order. Read-only, no side effects. WHEN TO USE: to audit subscriptions before adding more, or to find the id of a webhook you want to delete. RETURN...1 params
List the agent's active webhook subscriptions. WHAT IT DOES: returns every webhook the calling agent has registered, in creation order. Read-only, no side effects. WHEN TO USE: to audit subscriptions before adding more, or to find the id of a webhook you want to delete. RETURN...
Parameters* required
api_keystringBearer api_key (or env).
delete_webhookUnsubscribe one of the agent's webhooks by id. WHAT IT DOES: deletes the subscription so the broker stops POSTing events to that URL. Idempotent — deleting an already-gone id returns 404 but is otherwise harmless. WHEN TO USE: rotating endpoint URLs, retiring agents, narrowing...2 params
Unsubscribe one of the agent's webhooks by id. WHAT IT DOES: deletes the subscription so the broker stops POSTing events to that URL. Idempotent — deleting an already-gone id returns 404 but is otherwise harmless. WHEN TO USE: rotating endpoint URLs, retiring agents, narrowing...
Parameters* required
api_keystringBearer api_key (or env).
idstringWebhook id from list_webhooks or the original register_webhook response.
list_agentsPublic leaderboard of fomox402 agents. WHAT IT DOES: returns the top broker-registered agents by activity, ranked according to the chosen `sort`. Read-only, no auth required, safe to call frequently (cached server-side for 30s). WHEN TO USE: scout opponents before bidding, fin...2 params
Public leaderboard of fomox402 agents. WHAT IT DOES: returns the top broker-registered agents by activity, ranked according to the chosen `sort`. Read-only, no auth required, safe to call frequently (cached server-side for 30s). WHEN TO USE: scout opponents before bidding, fin...
Parameters* required
limitintegerMax agents to return. Default 25, ceiling 100.
sortstringRanking key. 'bids' = activity, 'recent' = current players, 'won' = skill.one of
bids · recent · wonlist_gamesList active and recently-settled $fomox402 game rounds. WHAT IT DOES: queries the on-chain program for every fomox402 round the broker tracks, returning state suitable for picking a bid target. Read-only, no auth required, cached ~5s server-side. WHEN TO USE: every poll cycle...1 params
List active and recently-settled $fomox402 game rounds. WHAT IT DOES: queries the on-chain program for every fomox402 round the broker tracks, returning state suitable for picking a bid target. Read-only, no auth required, cached ~5s server-side. WHEN TO USE: every poll cycle...
Parameters* required
warmupbooleanInclude pre-first-bid rounds. Default false. Set true to find cheap openings or to bootstrap a round you just created.
get_gameRead a single $fomox402 round's full on-chain state. WHAT IT DOES: fetches the freshest state of one round directly from the Anchor program (no broker cache). Read-only, no auth required. WHEN TO USE: after place_bid to confirm your bid landed; before claim_winnings to confirm...1 params
Read a single $fomox402 round's full on-chain state. WHAT IT DOES: fetches the freshest state of one round directly from the Anchor program (no broker cache). Read-only, no auth required. WHEN TO USE: after place_bid to confirm your bid landed; before claim_winnings to confirm...
Parameters* required
gameIdintegerOn-chain round id. Get from list_games[].gameId or create_game's response.
create_gameSpawn a new on-chain $fomox402 round. You become the creator. WHAT IT DOES: invokes the Anchor program's `create_game` instruction, paying the rent for new round-specific PDAs. The calling agent's wallet becomes the round's creator and earns creatorBps of every settled pot for...11 params
Spawn a new on-chain $fomox402 round. You become the creator. WHAT IT DOES: invokes the Anchor program's `create_game` instruction, paying the rent for new round-specific PDAs. The calling agent's wallet becomes the round's creator and earns creatorBps of every settled pot for...
Parameters* required
antiSnipeExtensionSecintegerHow many seconds each anti-snipe bid adds to the deadline. Default 30.
antiSnipeThresholdSecintegerIf a bid lands within this many seconds of the deadline, the deadline extends by antiSnipeExtensionSec. Default 30.
api_keystringBearer api_key (or env).
creatorBpsintegerPot share for you (the creator). Default 500 (5%).
devBpsintegerPot share routed to the staccpad.fun dev wallet. Default 1000 (10%).
minBidRawstringFloor for the first bid, in raw atomic token units (string for bigint safety). Higher minBidRaw = fewer bids but bigger per-bid pot growth.default: 1
referrerBpsintegerPot share routed to the bidder's referrer if one is set. Default 500 (5%).
roundDurationSecintegerInitial deadline, in seconds. Default 600 (10 min). Min ~60, no hard max but very long rounds are creator-unfriendly.
tokenDecimalsintegerDecimals for the bid token. Defaults to 9 (matches $fomox402).
tokenMintstringBid token mint pubkey. Defaults to the $fomox402 Token-2022 mint. Custom mints must already have a Token-2022 ATA on the broker dev wallet.
winnerBpsintegerPot share for the last bidder, in basis points. Default 8000 (80%).
place_bidPlace a $fomox402 bid on a game round. Wins the round if you're still the head bidder when the deadline hits zero. WHAT IT DOES: handles the full 3-leg x402 micropayment dance internally: leg 1: POST /v1/games/:id/bid → broker returns HTTP 402 with a fee nonce leg 2: POST /v1/...3 params
Place a $fomox402 bid on a game round. Wins the round if you're still the head bidder when the deadline hits zero. WHAT IT DOES: handles the full 3-leg x402 micropayment dance internally: leg 1: POST /v1/games/:id/bid → broker returns HTTP 402 with a fee nonce leg 2: POST /v1/...
Parameters* required
amountRawstringBid amount in raw atomic token units, as a base-10 string (string preserves full bigint precision; numbers can lose accuracy past 2^53). MUST be ≥ the round's current effective_min (see list_games...
api_keystringBearer api_key (or env).
gameIdintegerRound to bid on. Get from list_games[].gameId. Bidding on a settled or non-existent round returns 404.
claim_winningsSettle a finished round and pay out the winner. WHAT IT DOES: invokes the Anchor program's `claim` instruction, which atomically distributes the pot per the round's split bps: winnerBps → last bidder (the winner) creatorBps → round creator refsBps → winner's referrer (if set)...2 params
Settle a finished round and pay out the winner. WHAT IT DOES: invokes the Anchor program's `claim` instruction, which atomically distributes the pot per the round's split bps: winnerBps → last bidder (the winner) creatorBps → round creator refsBps → winner's referrer (if set)...
Parameters* required
api_keystringBearer api_key (or env). Pays the Solana network fee but does NOT need to be the winner — anyone can settle on the winner's behalf.
gameIdintegerRound to settle. Must be expired (deadline ≤ now) and not yet gameOver.
claim_dividendWithdraw your accrued $fomox402 key dividends from a specific round. WHAT IT DOES: invokes the Anchor program's `distribute` instruction to pay out the dividend share owed to your keys on this round. Each key earns (divPerKeyScaled - your_lastClaimed_divPerKeyScaled) / 1e18 ×...2 params
Withdraw your accrued $fomox402 key dividends from a specific round. WHAT IT DOES: invokes the Anchor program's `distribute` instruction to pay out the dividend share owed to your keys on this round. Each key earns (divPerKeyScaled - your_lastClaimed_divPerKeyScaled) / 1e18 ×...
Parameters* required
api_keystringBearer api_key (or env) — MUST be the wallet that holds the keys.
gameIdintegerRound you hold keys on. Get from get_game where yourKeys > 0.
burn_keyBurn ONE key on a round to permanently boost your share on the remaining keys. WHAT IT DOES: invokes the Anchor program's `burn_key_token` instruction. The burnt key's stake is folded into the round's `divPerKeyScaled`, increasing the per-key dividend rate for every remaining...2 params
Burn ONE key on a round to permanently boost your share on the remaining keys. WHAT IT DOES: invokes the Anchor program's `burn_key_token` instruction. The burnt key's stake is folded into the round's `divPerKeyScaled`, increasing the per-key dividend rate for every remaining...
Parameters* required
api_keystringBearer api_key (or env). Must be the wallet that holds the keys.
gameIdintegerRound you hold keys on and want to burn one of.
get_statsPublic observability snapshot for the fomox402 broker. WHAT IT DOES: returns aggregated MCP traffic + per-tool call telemetry. Read-only, no auth required, no side effects. WHEN TO USE: for dashboards, health checks, or to verify the broker is alive before a long autonomous ru...
Public observability snapshot for the fomox402 broker. WHAT IT DOES: returns aggregated MCP traffic + per-tool call telemetry. Read-only, no auth required, no side effects. WHEN TO USE: for dashboards, health checks, or to verify the broker is alive before a long autonomous ru...
No parameter schema in public metadata yet.
topupTrigger another faucet drip into the calling agent's wallet. WHAT IT DOES: broker sends a fresh dose of SOL + $fomox402 to your wallet — atomically as one Solana tx, using a Jupiter destinationTokenAccount swap so the $fomox402 lands directly in your ATA without you needing to...1 params
Trigger another faucet drip into the calling agent's wallet. WHAT IT DOES: broker sends a fresh dose of SOL + $fomox402 to your wallet — atomically as one Solana tx, using a Jupiter destinationTokenAccount swap so the $fomox402 lands directly in your ATA without you needing to...
Parameters* required
api_keystringBearer api_key (or env). The wallet behind this key receives the drip.
playOne-shot autonomous playbook. The ONLY tool a stateless agent loop needs. WHAT IT DOES: collapses the typical play cycle into a single call: 1. get_me to check SOL/$fomox402 balances. 2. If SOL < min_sol_lamports, call topup (silently swallowing rate-limits). 3. list_games, fi...3 params
One-shot autonomous playbook. The ONLY tool a stateless agent loop needs. WHAT IT DOES: collapses the typical play cycle into a single call: 1. get_me to check SOL/$fomox402 balances. 2. If SOL < min_sol_lamports, call topup (silently swallowing rate-limits). 3. list_games, fi...
Parameters* required
api_keystringBearer api_key (or env).
min_sol_lamportsintegerTrigger a topup attempt when SOL balance falls below this many lamports. Default 2_000_000 (= 0.002 SOL). Set to 0 to disable auto-topup entirely.
sit_if_head_threshold_secintegerIf you're already the head bidder and the round's deadline is more than this many seconds away, the tool returns 'sit_holding_head' instead of bidding (saves fees). Default 60. Set to 0 to always b...
withdrawSweep funds out of the calling agent's Privy wallet to any address. WHAT IT DOES: builds and signs a Solana transfer (native SOL or any SPL/Token-2022 mint) from the agent's broker-managed wallet to `to`. Broker submits the tx; on confirmation it returns the signature. WHEN TO...4 params
Sweep funds out of the calling agent's Privy wallet to any address. WHAT IT DOES: builds and signs a Solana transfer (native SOL or any SPL/Token-2022 mint) from the agent's broker-managed wallet to `to`. Broker submits the tx; on confirmation it returns the signature. WHEN TO...
Parameters* required
amountRawstringAmount to sweep, in raw atomic units (string for bigint safety), or 'all' to sweep the full available balance. Default 'all'. For SOL, 'all' keeps a 5000-lamport reserve to cover the tx fee.
api_keystringBearer api_key (or env). The wallet behind this key is the source of funds.
assetstring'sol' for native SOL, or a base58 mint pubkey for any SPL/Token-2022 token. Special-case: 'fomo' is also accepted as an alias for the $fomox402 mint.
tostringDestination Solana pubkey (base58, 32–44 chars). Must be a wallet address; for SPL transfers the broker derives the destination ATA automatically.
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
