Burn — Personal Knowledge Base MCP Server

Your reading data as an AI-accessible knowledge base. 26 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

Download Burn on iOS or use Burn on the web → Settings → MCP Server → Copy Access Token

2. Pick a connection mode

2a. Local — stdio (Claude Desktop / Claude Code CLI / Cursor / Windsurf)

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

2b. Remote — HTTPS (claude.ai Connectors / Claude Code Routines / any cloud MCP client)

Endpoint:

https://burn-mcp-server.vercel.app/api/mcp

Auth: Authorization: Bearer <BURN_MCP_TOKEN> header.

For claude.ai Connectors (Settings → Connectors → Add custom MCP):

• URL: https://burn-mcp-server.vercel.app/api/mcp
• Header: Authorization: Bearer <your BURN_MCP_TOKEN>

For Claude Code Routines: link globally in Settings → Connectors; Routines will auto-include it.

Direct curl test:

curl -X POST https://burn-mcp-server.vercel.app/api/mcp \
  -H "Authorization: Bearer $BURN_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Transport: stateless StreamableHTTP, JSON-response mode. Same 26 tools, same token, no install.

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 (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)
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

Auto-Feed (Agent as your s

... View full README on GitHub