Fisher521/burn-mcp-server

> Want this badge in your own README? Grab the markdown at burn451.cloud/developers#badges.
Your reading data as an AI-accessible knowledge base. 26 tools for Claude, Cursor, Windsurf, and any MCP-compatible agent.
**Watch the real Claude → Burn walkthrough** — the exact read-only prompt, tool calls, sources, and limits are published so you can reproduce it.
> **You need a free Burn account to use this server.** Fastest path: open Burn on the web → **Settings → MCP Server → Copy Access Token**. Prefer the app? Download Burn for iPhone. Burn has a free tier (5 saves/day, all 26 MCP tools included) and a Pro plan at $4.99/month for unlimited saves.
How it works
Burn is a read-later app with a 24-hour deadline — saves auto-burn unless you read or rescue them. The honest answer to the bookmark graveyard problem — research suggests 84% of saved bookmarks are never revisited (Bergman, Whittaker & Schooler, 2021).
Triage flow:
- **Flame** → New links. 24h to read or they burn.
- **Spark** → You read it. Stays 30 days.
- **Vault** → Permanent. Your curated knowledge.
- **Ash** → Expired. They had their chance.
The MCP server lets your AI agent search, triage, organize, and analyze everything you've saved. Built for Claude users who want their reading history as context.
> **Migrating from another tool?** Burn is a Pocket replacement (Mozilla shut Pocket down July 2025), an Omnivore alternative (acquired by ElevenLabs late 2024), and a Matter app alternative.
Quick Start
1. Get your token
1. Create a free Burn account — iOS app or web
2. Open the app → **Settings → MCP Server → Generate token → Copy**
The server exchanges your token for a short-lived Supabase session and caches it in ~/.burn/mcp-session.json. No re-login on each run.
2a. Remote — Streamable HTTP (fastest)
Use the hosted endpoint with the same Burn token. Nothing runs locally:
For claude.ai, open **Settings → Connectors → Add custom MCP**, use the endpoint above, and add the same Authorization header.
2b. Local — stdio fallback
Run the npm package locally in Claude Desktop, Cursor, Windsurf, or Claude Code:
3. Start asking
- "What did I save about system design?"
- "Triage my Flame — what should I keep?"
- "Create a collection from my AI bookmarks"
Add to Cursor
.cursor/mcp.json:
Add to Claude Code (CLI)
Example prompts
Reading triage:
- "Go through my Flame inbox, read each article, keep anything about AI agents and burn the rest."
- "What's about to expire in the next 6 hours that I'd regret losing?"
Knowledge retrieval:
- "Search my Vault for everything on context engineering and summarize the main schools of thought."
- "Which authors do I save most often? What does that say about my reading gaps?"
Research curation:
- "Create a collection called 'MCP in production' from my saves, then write an overview of what my sources agree and disagree on."
- "Add a watched source for Simon Willison's blog so new posts land in my Flame."
Writing with your own sources:
- "I'm writing about read-later apps. Pull every relevant bookmark I have and list the claims I can support with a source."
Tools (26)
Search & Read
| Tool | What it does |
|------|-------------|
| search_vault | Search permanent bookmarks by keyword |
| list_vault | List Vault bookmarks by category |
| list_sparks | List recently read bookmarks (30-day window) |
| search_sparks | Search Sparks by keyword |
| list_flame | List inbox — what's about to burn |
| get_flame_detail | Full detail on a Flame bookmark |
| get_bookmark | Get any bookmark by ID |
| get_article_content | Get full article content + analysis |
| fetch_content | Fetch content from a URL (X, Reddit, YouTube, WeChat) |