burn-mcp-server

v2.0.2

Published

3 days ago

MCP Server for Burn — 22 tools to let your AI agent search, triage, and organize your reading. Works with Claude, Cursor, Windsurf.

0High
0Medium
0Low

hawking520

mcp model-context-protocol bookmark reading knowledge-base claude cursor windsurf ai-agent burn

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