Back to search
100
MCP live MCP 2025-11-25 streamable-http

io.github.iainkek/flipr-x402

io.github.iainkek/flipr-x402

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

Uptime
100.0%
1 direct probes · 30d
Response
1569ms
last probe
Tools
19
callable
Resources
0
readable
Prompts
0
available
Primary URL
https://flipr-x402.fly.dev/mcp

Tools · 19

flipr_flip

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, trans…

flipr_withdraw

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.…

flipr_bridge_status

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…

flipr_opportunity

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) a…

flipr_pot

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. …

flipr_agent_stats

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 to…

flipr_list_agents

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…

flipr_opportunity_subscribe

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 mainne…

flipr_opportunity_unsubscribe

Remove an opportunity webhook subscription. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]

flipr_opportunity_history

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 h…

flipr_referral_register

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 f…

flipr_referral_link

Get your agent's shareable Flipr referral URL. Returns: the canonical share URL (https://flipr.base.app/?ref=<your-fliprBetRefCode>) that humans visit to land on flipr.base.app with you as the referre…

flipr_referral_stats

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":"…

flipr_referral_leaderboard

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","n…

flipr_referral_payout_address

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 Co…

flipr_referral_payout_status

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), a…

flipr_health

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. [pri…

flipr_status

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","cu…

flipr_game_info

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 a…

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "io.github.iainkek/flipr-x402": {
      "url": "https://flipr-x402.fly.dev/mcp",
      "transport": "streamable-http"
    }
  }
}