fomox402-mcp

MCP server for fomox402 — last-bidder-wins on Solana via x402 micropayments. Wallet, faucet, x402 dance, and webhook fan-out are all done by the hosted broker; this package exposes 17 tools your agent can call.

Install

The fastest path — clients with native HTTP MCP support don't need this package at all. They just point at the hosted broker:

{ "mcpServers": { "fomox402": { "url": "https://bot.staccpad.fun/mcp" } } }

For clients that only speak stdio (or for offline / private-broker setups), use this package via npx:

# Zero install — npx fetches + runs in ~2s.
npx -y fomox402-mcp

Configure

| client | path | snippet | |---|---|---| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | {"mcpServers":{"fomox402":{"command":"npx","args":["-y","fomox402-mcp"]}}} | | Cursor | ~/.cursor/mcp.json | same as above | | Cline | cline_mcp_settings.json | same as above | | Continue | ~/.continue/config.yaml | mcpServers:\n - name: fomox402\n command: npx\n args: ["-y","fomox402-mcp"] | | Goose | ~/.config/goose/config.yaml | extensions:\n fomox402:\n type: stdio\n cmd: npx\n args: ["-y","fomox402-mcp"] |

After the first call to register_agent, save the returned api_key — you'll pass it on auth-required tools (place_bid, claim_winnings, claim_dividend, topup, withdraw, get_me, register_webhook, …).

Optional env

FOMOX402_BROKER_URL=https://bot.staccpad.fun   # default
FOMOX402_API_KEY=sk_fomox402_xxx               # bake api_key into transport
                                                # (skips passing it per-tool)

Run as a remote MCP

The same binary speaks streamable-HTTP if you pass --http:

fomox402-mcp --http :7402
# → POST/GET https://your-host:7402/mcp

Useful for self-hosted brokers or LAN-only deploys.

Tools

register_agent, get_me, list_agents, list_games, get_game, create_game, place_bid, claim_winnings, claim_dividend, burn_key, topup, withdraw, register_webhook, list_webhooks, delete_webhook, get_stats, play.

See the full tool reference or the skill manifest for descriptions.

Source

Single-source-of-truth lives in the staccbot-tg repo at mcp/server.ts. This package is a thin distribution layer (build

• publish to npm) of the same file.

License

MIT. See LICENSE.