Burn Mcp Server

@Fisher521

About Burn Mcp Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Search your Burn Vault for bookmarks by keyword (searches title, tags, AI takeaway)

List bookmarks in your Vault, optionally filtered by category

List your Sparks (bookmarks you have read, with 30-day lifespan). Includes spark insight and expiry date.

Search your Sparks by keyword (searches title, tags, AI takeaway, spark insight)

Get full details of a single bookmark including AI analysis and extracted content

Get full article content and AI analysis for a bookmark by ID (same as get_bookmark)

Fetch 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 all Vault categories with article counts

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

List all your Collections with article counts and AI overview themes

Get a Collection by name with its AI overview and linked bookmarks metadata

Move a Flame bookmark to Spark (mark as worth reading). Sets 30-day Spark lifespan.

Burn a Flame bookmark to Ash (not worth keeping).

Promote a Spark bookmark to permanent Vault storage.

Burn a Spark bookmark to Ash (not valuable enough to vault).

Triage multiple Flame bookmarks at once. Each decision moves a bookmark to Spark or Ash.

Write 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 a new Collection to group related bookmarks together.

Add bookmarks to an existing Collection. Duplicates are silently ignored.

Remove bookmarks from a Collection.

Write an AI-generated overview for a Collection (theme, synthesis, patterns, gaps).

Watch an X user, RSS feed, or YouTube channel — new posts auto-appear in Burn Flame on each scrape.

List all active watched sources (X users, RSS feeds, YouTube channels).

Stop watching a source. Use list_watched_sources to find the source ID.

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

Overview

What is Burn Mcp Server?

Burn Mcp Server transforms your reading data into an AI-accessible knowledge base. It integrates a 24‑hour triage system (Flame → Spark → Vault → Ash) and offers 26 tools for use with Claude, Cursor, Windsurf, and any MCP‑compatible agent.

How to use Burn Mcp Server?

Obtain a token from the Burn iOS app or web settings, then configure your MCP client either via stdio (npx burn-mcp-server with BURN_MCP_TOKEN) or via the remote HTTPS endpoint https://burn-mcp-server.vercel.app/api/mcp using a Bearer token header. No installation is required for the remote mode.

Key features of Burn Mcp Server

26 tools for search, triage, collections, analysis, and auto‑feed
24‑hour reading inbox (Flame) that expires
Spark (30‑day) and Vault (permanent) bookmark tiers
Batch triage: move up to 20 bookmarks at once
Auto‑feed: watch X users, RSS feeds, or YouTube channels
Collection management with AI overview support

Use cases of Burn Mcp Server

Personal knowledge management – AI searches your reading history for patterns and forgotten gems
Research workflows – create topic collections and let the agent write synthesis overviews
Reading triage – agent reviews your inbox, reads content, and decides what to keep
Cross‑tool intelligence – bookmarks become context in Claude Code, Cursor, or Windsurf

FAQ from Burn Mcp Server

What is the triage system?

Links start as Flame (24h to read), become Spark after reading (30‑day window), and can be promoted to permanent Vault or moved to Ash (expired). The MCP server enforces this flow.

How do I get an access token?

Download the Burn iOS app or go to burn451.cloud, open Settings → MCP Server, and copy your long‑lived MCP token.

What transports are supported?

Two modes: local stdio (using npx burn-mcp-server with environment tokens) and remote HTTPS (stateless StreamableHTTP at https://burn-mcp-server.vercel.app/api/mcp).

What are the rate limits and token expiration?

Rate limit is 30 calls per minute per session. MCP tokens expire after 30 days.

What authentication is required?

Either BURN_MCP_TOKEN (recommended) or legacy BURN_SUPABASE_TOKEN must be set. The token is scoped to your data via Row Level Security.

Frequently asked questions

What is the triage system?

Links start as Flame (24h to read), become Spark after reading (30‑day window), and can be promoted to permanent Vault or moved to Ash (expired). The MCP server enforces this flow.

How do I get an access token?

Download the Burn iOS app or go to [burn451.cloud](https://burn451.cloud), open Settings → MCP Server, and copy your long‑lived MCP token.

What transports are supported?

Two modes: local stdio (using `npx burn-mcp-server` with environment tokens) and remote HTTPS (stateless StreamableHTTP at `https://burn-mcp-server.vercel.app/api/mcp`).