README.md
Flappy Bird MCP App
A fully playable Flappy Bird game that runs inline in AI chat clients via MCP Apps.
Setup
bun install
bun run build
Run
bun run serve
Server starts at http://localhost:3001/mcp.
Expose via tunnel (for remote hosts like ChatGPT, Claude.ai)
cloudflared tunnel --url http://localhost:3001
Use the generated https://*.trycloudflare.com/mcp URL as your MCP server endpoint.
Configure
VS Code (1.109+)
See the VS Code MCP docs to add an HTTP server with URL http://localhost:3001/mcp.
ChatGPT
- Start the tunnel (see above)
- Go to chatgpt.com → Settings → Apps → Advanced Settings → enable Developer Mode
- Go back to Apps → click Create App
- Fill in the details and paste the tunnel URL:
https://<your-tunnel>.trycloudflare.com/mcp - Change Authentication to No Auth, then check "I understand and want to continue"
- Click Create
Claude.ai
- Start the tunnel (see above)
- Go to claude.ai → Settings → Connectors → click Add custom connector
- Paste the tunnel URL:
https://<your-tunnel>.trycloudflare.com/mcp - Click Add
Tools
| Tool | Description |
|---|---|
play-flappy-bird |
Launches the game (renders inline) |
submit-score |
Submits a score from the game UI |
get-high-score |
Returns the session high score |
Tools 3
play-flappy-birdLaunches the game and renders it inline.submit-scoreSubmits a score from the game UI.get-high-scoreReturns the session high score.Try it
→Launch the Flappy Bird game so I can play.
→What is the current high score for Flappy Bird?
→I just finished a round, please submit my score.