Burn

Personal Knowledge Base MCP — 26 tools that let AI agents search and read a user's curated reading, triage reading stages, organize collections, and write…

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Search Vault: Search your Burn Vault for bookmarks by keyword (searches title, tags, AI takeaway)
  • List Vault: List bookmarks in your Vault, optionally filtered by category
  • List Sparks: List your Sparks (bookmarks you have read, with 30-day lifespan). Includes spark insight and expiry date.

What data it sees

Do you need an account

No: the server works without sign-in

Personal Knowledge Base MCP — 26 tools that let AI agents search and read a user's curated reading, triage reading stages, organize collections, and write analysis back. Hosted Streamable HTTP and local npx install.

How to connect

How to connect Burn to Claude

The server address to paste into Claude settings:

https://burn-mcp-server--hawking520.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Burn to ChatGPT

The server address to paste into ChatGPT settings:

https://burn-mcp-server--hawking520.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Burn to Cursor

The server address to paste into Cursor settings:

https://burn-mcp-server--hawking520.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (26)

Raw names from tools/list. Only developers need these.

search_vaultSearch your Burn Vault for bookmarks by keyword (searches title, tags, AI takeaway)
list_vaultList bookmarks in your Vault, optionally filtered by category
list_sparksList your Sparks (bookmarks you have read, with 30-day lifespan). Includes spark insight and expiry date.
search_sparksSearch your Sparks by keyword (searches title, tags, AI takeaway, spark insight)
get_bookmarkGet full details of a single bookmark including AI analysis and extracted content
get_article_contentGet full article content and AI analysis for a bookmark by ID (same as get_bookmark)
fetch_contentFetch article/tweet content from a URL. Works with X.com (bypasses GFW via proxy), Reddit, YouTube, Bilibili, WeChat, and any web page. First checks Supabase cache, then fetches live.
list_categoriesList all Vault categories with article counts
list_flameList bookmarks in your Flame inbox (24h countdown). Shows AI triage info (strategy, relevance, novelty, hook) and time remaining. Use this to see what needs attention before it burns to Ash.
get_flame_detailGet full details of a Flame bookmark including extracted article content, AI analysis, and reading guidance. Use this to deep-read a bookmark before deciding its fate.
get_collectionsList all your Collections with article counts and AI overview themes
get_collection_overviewGet a Collection by name with its AI overview and linked bookmarks metadata
move_flame_to_sparkMove a Flame bookmark to Spark (mark as worth reading). Sets 30-day Spark lifespan.
move_flame_to_ashBurn a Flame bookmark to Ash (not worth keeping).
move_spark_to_vaultPromote a Spark bookmark to permanent Vault storage.
move_spark_to_ashBurn a Spark bookmark to Ash (not valuable enough to vault).
batch_triage_flameTriage multiple Flame bookmarks at once. Each decision moves a bookmark to Spark or Ash.
write_bookmark_analysisWrite AI analysis results into a bookmark. Agent analyzes content with its own LLM, then writes structured results back to Burn. Only provided fields are merged — existing data is preserved.
create_collectionCreate a new Collection to group related bookmarks together.
add_to_collectionAdd bookmarks to an existing Collection. Duplicates are silently ignored.
remove_from_collectionRemove bookmarks from a Collection.
update_collection_overviewWrite an AI-generated overview for a Collection (theme, synthesis, patterns, gaps).
add_watched_sourceWatch an X user, RSS feed, or YouTube channel — new posts auto-appear in Burn Flame on each scrape.
list_watched_sourcesList all active watched sources (X users, RSS feeds, YouTube channels).
remove_watched_sourceStop watching a source. Use list_watched_sources to find the source ID.
scrape_watched_sourcesFetch new content from all watched sources (or one specific source) and add new items to Burn Flame. Call this on a schedule or on demand.