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 flow enforced: Flame → Spark → Vault, or → Ash
Rate limit: 30 calls/min per session
Tokens expire after 30 days

License

MIT

burn-mcp-server

Quick Install