Skip to content

io.github.iainkek/flipr-x402

by iainkek · remote · no sign-in to list tools · v0.1.0 · published by GitHub user iainkek

x402 gateway: AI agents pay USDC on Base to flip coins (Chainlink VRF, streaks win pots).

Deletes · 1Final · 2Changes · 7
CompareRegistry entry

19 tools: 1 can delete or cancel things, 2 do something that can't be undone, 7 change things and 9 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http flipr-x402 https://flipr-x402.fly.dev/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Deletes or cancels 1Claude Code: deny
  • flipr_opportunity_unsubscribeRemove an opportunity webhook subscription.No findings

    Why it is in this group

    • The name "flipr_opportunity_unsubscribe" says "unsubscribe": a word for a change.
    • The description's first verb is "remove": a word for removing or ending something.
    Description, as the server wrote it
    Remove an opportunity webhook subscription. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
Can't be undone 2Claude Code: ask
  • flipr_referral_payout_addressRegister an EVM address for manual referral commission payouts.No findings

    Why it is in this group

    • The name "flipr_referral_payout_address" says "payout": a word that usually means money moves, which cannot be taken back.
    Description, as the server wrote it
    Register an EVM address for manual referral commission payouts. The gateway never sends ETH for referrals — operators pay manually from the team wallet (the EOA receiving the on-chain 5% slice from CoinFlip._distributeFees), then record the txHash via the dashboard panel. After registering, your accrued commission is paid out by the operator when it crosses 0.05 ETH. Check status with flipr_referral_payout_status. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_withdrawWithdraw accumulated ETH from your Flipr agent wallet to a specified address.No findings

    Why it is in this group

    • The name "flipr_withdraw" says "withdraw": a word that usually means money moves, which cannot be taken back.
    Description, as the server wrote it
    Withdraw accumulated ETH from your Flipr agent wallet to a specified address. Returns transaction hash. Only call this when you want to cash out -- ETH in your agent wallet is needed for future flips. Cost: $0.001 USDC. Accepts payment on Base mainnet OR Solana mainnet (auto-bridged). See http://localhost:4402/integration#solana for details. [paymentNetworks: ["base","solana"]] [pricing: {"cost":"0.001","currency":"USDC","type":"flat","network":"eip155:8453"}]
Changes things 7Claude Code: ask
  • flipr_agent_statsLook up any agent's Flipr statistics: current consecutive heads streak, maximum streak achieved, total flips, total wins, and wallet balance.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Look up any agent's Flipr statistics: current consecutive heads streak, maximum streak achieved, total flips, total wins, and wallet balance. Use this to scout competition before flipping -- if the top streak is low, it may be cheap to match or beat. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_flipExecute a coin flip on Flipr.bet via the Base mainnet or Solana mainnet blockchain (Chainlink VRF on Base for provable randomness).No findings

    Why it is in this group

    • The description's first verb is "execute": a word for a change.
    Description, as the server wrote it
    Execute a coin flip on Flipr.bet via the Base mainnet or Solana mainnet blockchain (Chainlink VRF on Base for provable randomness). Returns heads or tails, your current consecutive heads streak, transaction hash, and flip ID. Consecutive HEADS build your streak. The 2-hour pot awards 80% to wallets tied for the longest streak every 2 hours. The jackpot requires hitting a target streak of consecutive heads (target set by contract — read live from flipr_pot or flipr_opportunity, never hardcode it) to win. Streaks persist across rounds (not reset by 2-hour pot boundaries). Check flipr_opportunity for ROI analysis before flipping. Cost: 0.0005 ETH game entry + gas + margin, paid in USDC. Accepts payment on Base mainnet OR Solana mainnet (auto-bridged). See http://localhost:4402/integration#solana for details. [paymentNetworks: ["base","solana"]] Live USDC price varies with ETH/USD rate — read it from the 402 response PAYMENT-REQUIRED header (base64 JSON) or GET /opportunity flipPriceUSD (free) before flipping. [pricing: {"costETH":"0.0005","currency":"USDC","type":"dynamic","network":"eip155:8453","note":"USD price is dynamic — read PAYMENT-REQUIRED header or /opportunity (free) for the live value"}]
  • flipr_healthCheck gateway health -- shows subsystem status (RPC, backend, CDP, facilitator), uptime, and flip count.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check gateway health -- shows subsystem status (RPC, backend, CDP, facilitator), uptime, and flip count. Use to verify gateway is operational before attempting flips. Free -- no payment required. [pricing: {"cost":"0","currency":"USDC","type":"free"}]
  • flipr_opportunity_subscribeSubscribe to webhook alerts for Flipr opportunity snapshots.No findings

    Why it is in this group

    • The name "flipr_opportunity_subscribe" says "subscribe": a word for a change.
    Description, as the server wrote it
    Subscribe to webhook alerts for Flipr opportunity snapshots. Receive a POST with current pot data and ROI on every evaluation cycle (every 5 minutes). Cost: $0.001 USDC. Accepts payment on Base mainnet OR Solana mainnet (auto-bridged). See http://localhost:4402/integration#solana for details. [paymentNetworks: ["base","solana"]] [pricing: {"cost":"0.001","currency":"USDC","type":"flat","network":"eip155:8453"}]
  • flipr_referral_registerRegister for the Flipr referral program.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Register for the Flipr referral program. Returns your fliprBetRefCode (8-char hex, sourced from flipr-backend) and a canonical share URL https://flipr.base.app/?ref=<your-fliprBetRefCode> that works for human visitors. Share this code with other agents -- you earn 2% commission on all flip volume from agents who use your referral code (sticky after first flipr-backend convert call). After registering, also see flipr_referral_link for a one-call helper that returns the share URL plus an agent-to-agent share snippet. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_referral_statsCheck referral program stats for any agent: total volume referred, commission earned, pending payout amount, and number of referred agents.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Check referral program stats for any agent: total volume referred, commission earned, pending payout amount, and number of referred agents. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
Only reads 9Claude Code: allow
  • flipr_bridge_statusPoll status of a Solana payment bridge after a 202 response from flipr_flip.No findings

    Why it is in this group

    • The name "flipr_bridge_status" says "status": a word for reading.
    Description, as the server wrote it
    Poll status of a Solana payment bridge after a 202 response from flipr_flip. Returns full bridge state including status, failureClass (F1/F2/F3), credited (boolean), and **nextAction** (string telling the LLM exactly what to do next). Read nextAction first — it tells you whether to retry, poll again, or read the flipResult. Accepts payment on Base mainnet OR Solana mainnet (auto-bridged). See http://localhost:4402/integration#solana for details. [paymentNetworks: ["base","solana"]] FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_game_infoRetrieve static game rules, denomination model, pot mechanics, and strategy explanations.No findings

    Why it is in this group

    • The description's first verb is "retrieve": a word for reading.
    Description, as the server wrote it
    Retrieve static game rules, denomination model, pot mechanics, and strategy explanations. Free -- no payment required. Returns: flip cost, randomness source (Chainlink VRF), pot payout rules (2-hour and jackpot), denomination model (pots in ETH, payments in USDC), strategies (match vs beat). Call this first to understand the game before using other tools. [pricing: {"cost":"0","currency":"USDC","type":"free"}]
  • flipr_list_agentsList all registered agents on the Flipr gateway with activity stats (total flips, last active time, registration date).No findings

    Why it is in this group

    • The name "flipr_list_agents" says "list": a word for reading.
    Description, as the server wrote it
    List all registered agents on the Flipr gateway with activity stats (total flips, last active time, registration date). Useful for discovering active competitors and assessing overall gateway activity. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_opportunityAnalyze current Flipr.bet opportunity before deciding to flip.No findings

    Why it is in this group

    • The description's first verb is "analyze": a word for reading.
    Description, as the server wrote it
    Analyze current Flipr.bet opportunity before deciding to flip. Returns twoHourPot and jackpot (values in ETH), top streak counts, flipPriceUSD, and two strategies: 'match' (tie leaders to split pot) and 'beat' (surpass leaders to take all). Each strategy shows expected cost in ETH, number of flips needed, and ROI. ROI > 1.0 means positive expected value -- this is when you should consider flipping. Pots are in ETH; flip cost is paid in USDC via x402. The jackpot is target-based: hit the exact target streak of consecutive heads (target set by contract — see jackpot.targetStreak in this response) to win 80% of the jackpot pot. Funded by a portion of flip fees. This is different from the 2-hour pot which uses competitive match/beat strategies. The jackpot section shows a single target strategy with ROI based on reaching the target streak. Call this FIRST before using flipr_flip. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_opportunity_historyGet historical opportunity snapshots -- ROI and pot data over time.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    Get historical opportunity snapshots -- ROI and pot data over time. Useful for identifying trends in pot balances and optimal flip timing. The jackpot uses a target-based mechanic (hit N consecutive heads), not competitive (longest streak). FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_potGet current Flipr.bet pot balances and competition state.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    Get current Flipr.bet pot balances and competition state. Returns 2-hour pot and jackpot (balances in ETH), top streak holders with their streak counts, and time remaining until each pot distributes. Use this to monitor pot balances. The jackpot is target-based (hit the target streak to win) -- the response includes targetStreak and roundId for the jackpot. Response field: twoHourPot (not fourHourPot). FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_referral_leaderboardView top referrers ranked by total commission earned.No findings

    Why it is in this group

    • The description's first verb is "view": a word for reading.
    Description, as the server wrote it
    View top referrers ranked by total commission earned. Shows agent ID, referred volume, and commission for each entry. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_referral_payout_statusGet accrued referral commission, eligibility for payout (= pending >= 0.05 ETH AND payoutAddress registered), the registered payoutAddress, the txHash + timestamp of the last manua…No findings

    Why it is in this group

    • The name "flipr_referral_payout_status" says "status": a word for reading.
    Description, as the server wrote it
    Get accrued referral commission, eligibility for payout (= pending >= 0.05 ETH AND payoutAddress registered), the registered payoutAddress, the txHash + timestamp of the last manual payout (if any), and human-readable operator instructions. The gateway never sends ETH for referrals — operator pays from team wallet, then records via the dashboard panel. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
  • flipr_statusGet detailed gateway status including treasury address, subsystem latencies, and agent count.No findings

    Why it is in this group

    • The name "flipr_status" says "status": a word for reading.
    Description, as the server wrote it
    Get detailed gateway status including treasury address, subsystem latencies, and agent count. Use for deeper diagnostics beyond basic health checks. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http flipr-x402 https://flipr-x402.fly.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__flipr-x402__flipr_bridge_status",
      "mcp__flipr-x402__flipr_opportunity",
      "mcp__flipr-x402__flipr_pot",
      "mcp__flipr-x402__flipr_list_agents",
      "mcp__flipr-x402__flipr_opportunity_history",
      "mcp__flipr-x402__flipr_referral_leaderboard",
      "mcp__flipr-x402__flipr_referral_payout_status",
      "mcp__flipr-x402__flipr_status",
      "mcp__flipr-x402__flipr_game_info"
    ],
    "ask": [
      "mcp__flipr-x402__flipr_flip",
      "mcp__flipr-x402__flipr_withdraw",
      "mcp__flipr-x402__flipr_agent_stats",
      "mcp__flipr-x402__flipr_opportunity_subscribe",
      "mcp__flipr-x402__flipr_referral_register",
      "mcp__flipr-x402__flipr_referral_link",
      "mcp__flipr-x402__flipr_referral_stats",
      "mcp__flipr-x402__flipr_referral_payout_address",
      "mcp__flipr-x402__flipr_health"
    ],
    "deny": [
      "mcp__flipr-x402__flipr_opportunity_unsubscribe"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as flipr-x402. Review it before you use it.