Burn — Personal Knowledge Base MCP Server

Your reading data as an AI-accessible knowledge base. 22 tools for Claude, Cursor, Windsurf, and any MCP-compatible agent.

How it works

Burn triages your reading with a 24h timer:

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

Quick Start

1. Get your token

Open Burn App → Settings → MCP Server → Copy Access Token

2. Add to Claude Desktop

{
  "mcpServers": {
    "burn": {
      "command": "npx",
      "args": ["burn-mcp-server"],
      "env": {
        "BURN_MCP_TOKEN": "<your-token>"
      }
    }
  }
}

3. Start asking

• "What did I save about system design?"
• "Triage my Flame — what should I keep?"
• "Create a collection from my AI bookmarks"

Tools (22)

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) | | list_categories | All Vault categories with counts | | get_collections | List all Collections | | get_collection_overview | Collection detail with AI overview |

Triage (Agent as your filter)

| Tool | What it does | |------|-------------| | move_flame_to_spark | Keep it — worth reading. Optional insight. | | move_flame_to_ash | Burn it. Optional reason. | | move_spark_to_vault | Promote to permanent. Optional category. | | move_spark_to_ash | Not valuable enough to keep. | | batch_triage_flame | Triage up to 20 at once. |

Collections (Agent as your curator)

| Tool | What it does | |------|-------------| | create_collection | Create a topic bundle with initial bookmarks | | add_to_collection | Add bookmarks (deduplicates) | | remove_from_collection | Remove bookmarks | | update_collection_overview | Write AI overview (theme, synthesis, gaps) |

Analysis (Agent as your analyst)

| Tool | What it does | |------|-------------| | write_bookmark_analysis | Write structured analysis back to a bookmark |

Resources

| URI | Content | |-----|---------| | burn://vault/bookmarks | All Vault bookmarks (JSON) | | burn://vault/categories | Category list (JSON) |

Use Cases

Personal knowledge management — Your agent searches your reading history to answer questions, find patterns, and surface forgotten gems.

Research workflows — Create collections on topics you're exploring. Agent writes overviews synthesizing your sources.

Reading triage — Agent reviews your Flame inbox, reads the content, decides what's worth keeping based on your interests.

Cross-tool intelligence — Use with Claude Code, Cursor, or Windsurf. Your bookmarks become context for coding, writing, and thinking.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BURN_MCP_TOKEN | Yes* | Long-lived MCP token (recommended) | | BURN_SUPABASE_TOKEN | Yes* | Legacy JWT token (still supported) | | BURN_API_URL | No | Custom API URL (default: production) |

*One of BURN_MCP_TOKEN or BURN_SUPABASE_TOKEN required.

Security

• Token scoped to your data only (Row Level Security)
• Status

... View full README on GitHub