MCP server

Flipr X402

io.github.iainkek/flipr-x402

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

19

Token cost

About 4,169 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.flipr-x402]
url = "https://flipr-x402.fly.dev/mcp"

Gemini CLI

{"mcpServers":{"flipr-x402":{"httpUrl":"https://flipr-x402.fly.dev/mcp"}}}

Cursor

{"mcpServers":{"flipr-x402":{"url":"https://flipr-x402.fly.dev/mcp"}}}

VS Code

{"servers":{"flipr-x402":{"type":"http","url":"https://flipr-x402.fly.dev/mcp"}}}

Antigravity

agy mcp add flipr-x402 https://flipr-x402.fly.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"flipr-x402","server_url":"https://flipr-x402.fly.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"flipr-x402","server_url":"https://flipr-x402.fly.dev/mcp"}

Tools

• flipr_agent_stats ~182 tokens
  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","
• flipr_bridge_status ~273 tokens
  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
• flipr_flip ~449 tokens
  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
• flipr_game_info ~163 tokens
  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 th
• flipr_health ~116 tokens
  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_list_agents ~224 tokens
  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:
• flipr_opportunity ~331 tokens
  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 n
• flipr_opportunity_history ~185 tokens
  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":
• flipr_opportunity_subscribe ~232 tokens
  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. [payme
• flipr_opportunity_unsubscribe ~132 tokens
  Remove an opportunity webhook subscription. FREE — rate-limited only. [pricing: {"cost":"0","currency":"FREE","type":"free","network":"eip155:8453"}]
• flipr_pot ~190 tokens
  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
• flipr_referral_leaderboard ~143 tokens
  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_link ~288 tokens
  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 referrer (flipr-backend captures attribution via User.referredBy on conversion). Also returns: an x-ref sni
• flipr_referral_payout_address Moves money · ~268 tokens
  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 acc
• flipr_referral_payout_status ~221 tokens
  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 f
• flipr_referral_register ~261 tokens
  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 fr
• flipr_referral_stats ~152 tokens
  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"}]
• flipr_status ~118 tokens
  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"}]
• flipr_withdraw ~241 tokens
  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://loc

Browse

• GitHub tools
• Website monitoring
• Payments
• GitHub and code hosting
• Calling other AI models

Related MCP servers

• GW8 Signal API
  Pay-per-call crypto signals, token verdicts, flows & briefs. x402 USDC on Base. Signal-only.
• Blackwood State
  Pay-per-call tools for agents: onchain data, ECB FX rates, text tools. USDC on Base, x402
• Scrapling x402 Data Store
  DeFi TVL (880+ protocols), yields, perps, memecoins, SEC filings, top traders. Pay per call, x402.
• Apex Edge — x402-paid machine services
  x402-paid MCP tools: utils, audit screens, corpus search, inference. USDC Base+Solana.
• draconic21 Daily Agent Signal + x402 Data Tools
  Daily Agent Signal: x402 research; coverage varies. Free preview, $0.03 USDC on Base. SEC/OFAC.
• Money Maker x402 tools: EVM reads + AI tasks
  x402 pay-per-call: EVM balances, tx decode, transfers; AI extract, classify, embed, speech, image
• Agent Data Tools: Utilities
  92 tools: JSON repair, CSV, hashes, cron, dates, units, validators. 25 free calls.
• Fair Random
  Fair, reproducible randomness for agents: dice, coins, integers, list picks, shuffles, with seeds.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.iainkek/flipr-x402.svg)](https://aptlynx.net/servers/io.github.iainkek/flipr-x402)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents