flapjax-mcp

Read-only FLAPJAX on-chain state for agents — a zero-dependency Model Context Protocol server (stdio).

Seven tools over the FLAPJAX/WBNB 1% PancakeSwap V3 pool on BSC, the FlapJax treasury, any BSC address, and the FlapJax x402 checker on Base. No API keys held by the server, no transactions, no writes — only eth_call / eth_getBalance / eth_blockNumber against public BSC RPCs (with fallback across four endpoints) and read-only HTTP calls to the checker.

Install

git clone https://github.com/kaminariouji/flapjax-mcp
# no dependencies; Node.js >= 18

MCP client config (Claude Desktop, Cursor, or any MCP client):

{
  "mcpServers": {
    "flapjax": {
      "command": "node",
      "args": ["/absolute/path/to/flapjax-mcp/index.mjs"]
    }
  }
}

Related MCP server: BNB Chain MCP Server

Tools

Verified sample (block 127,053,470 — 2026-10-11)

depth with percent: 2:

{
  "up":   { "netWbnbIn": 0.06488399, "grossWbnbIn": 0.06553938, "fjOut": 155378465.32 },
  "down": { "netFjIn": 160111004.59, "wbnbOut": 0.06553614 }
}

These reproduce — to the digit — the numbers independently reconciled in the public Q18 review: the +2% gross depth of 0.065539 WBNB, and the two fee conventions (gross = net/0.99).

quote with side: "buy", amount: 0.01:

{ "amountOut": 23907253.97, "amountOutSide": "FJ", "route": "WBNB -> FLAPJAX (1% pool)" }

Matches the clean-table convention quote at the same pinned block (23,907,253.97).

treasury:

{
  "balances": { "bnb": 0.15464914, "flapjax": 213830043.84, "wbnb": 0 },
  "buybackContext": { "derivedAvailableBnb": 0.04464914, "wouldBuyNow": true }
}

check_address on 0x8c062dc5d775b7d5efc168f75a875f392f53dcdf:

{ "bnb": 5.25e-7, "flapjax": 1750000, "wbnb": 0 }

check_token on the same address (free mode — live 402 terms + FJ credits, 2026-10-12):

{
  "checker": "https://flapjax-check.run402.com",
  "fj_credit": { "status": 200, "body": { "credits": 0, "used": 0 } },
  "full_check_http_status": 402,
  "payment_terms": {
    "scheme": "exact", "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount_base_units": "20000", "amount_usd": 0.02,
    "pay_to": "0x3393319386c77ea0e8873a9bf510f1b6668a02a8"
  },
  "paid_result": { "note": "full paid check not attempted: set FLAPJAX_X402_KEY ..." }
}

The paid path is opt-in and host-owned: the tool signs the x402 payment locally with your key (FLAPJAX_X402_KEY env, the host's own wallet — the server never bundles or stores any key). Install the optional x402-fetch package for it:

npm install x402-fetch
FLAPJAX_X402_KEY=0x... node index.mjs   # full checks enabled; $0.02 USDC/call on Base

FJ lane: 1,000,000 FLAPJAX = 20 checks (send to the FlapJax treasury, redeem via /fj/redeem).

Notes & caveats

• Read-only. Public data, not financial advice. Public RPC endpoints may rate-limit.

• Historical eth_getLogs is blocked on most public BSC RPCs; this server deliberately uses only calls that work without an archive key.

• Known quirk (also returned by info): Pancake V3 tickBitmap is indexed by compressed tick (tick / tickSpacing = 200 for this pool), not the raw tick.

• Related: the browser probe at https://kaminariouji.github.io/flapjax-probe/.

MIT license.