burn-mcp-server 2.0.5 → 2.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Burn451
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/burn-mcp-server.svg)](https://www.npmjs.com/package/burn-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Your reading data as an AI-accessible knowledge base. 22 tools for Claude, Cursor, Windsurf, and any MCP-compatible agent.
+Your reading data as an AI-accessible knowledge base. 26 tools for Claude, Cursor, Windsurf, and any MCP-compatible agent.
 
 ## How it works
 
@@ -21,7 +21,35 @@ The MCP server lets your AI agent search, triage, organize, and analyze everythi
 
 Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [Burn on the web](https://burn451.cloud) → Settings → MCP Server → **Copy Access Token**
 
-### 2. Add to Claude Desktop
+### 2. Connect (pick one)
+
+#### Option A — Remote HTTP (recommended, no install)
+
+Add this URL to your MCP client. Works with Claude Desktop, Cursor, Windsurf, ChatGPT desktop, anything that speaks MCP Streamable HTTP:
+
+```
+https://mcp.burn451.cloud/mcp
+```
+
+Authorization header: `Bearer <your-token>`
+
+Claude Desktop config:
+```json
+{
+  "mcpServers": {
+    "burn": {
+      "url": "https://mcp.burn451.cloud/mcp",
+      "headers": { "Authorization": "Bearer <your-token>" }
+    }
+  }
+}
+```
+
+No Node install, no npx, no local process — one URL and you're in.
+
+#### Option B — Local stdio (npm install)
+
+For offline / privacy-sensitive setups where you don't want requests going through burn451.cloud:
 
 ```json
 {
@@ -43,7 +71,7 @@ Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [
 - "Triage my Flame — what should I keep?"
 - "Create a collection from my AI bookmarks"
 
-## Tools (22)
+## Tools (26)
 
 ### Search & Read
 
@@ -87,6 +115,15 @@ Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [
 |------|-------------|
 | `write_bookmark_analysis` | Write structured analysis back to a bookmark |
 
+### Auto-Feed (Agent as your scout)
+
+| Tool | What it does |
+|------|-------------|
+| `add_watched_source` | Watch an X user, RSS feed, or YouTube channel. New posts flow into Flame automatically. |
+| `list_watched_sources` | List all active watched sources |
+| `remove_watched_source` | Stop watching a source |
+| `scrape_watched_sources` | Fetch new content from watched sources on demand |
+
 ## Resources
 
 | URI | Content |
@@ -104,7 +141,7 @@ Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [
 
 **Cross-tool intelligence** — Use with Claude Code, Cursor, or Windsurf. Your bookmarks become context for coding, writing, and thinking.
 
-## Environment Variables
+## Environment Variables (stdio mode)
 
 | Variable | Required | Description |
 |----------|----------|-------------|
@@ -114,6 +151,33 @@ Download [Burn on iOS](https://apps.apple.com/app/burn451/id6759418544) or use [
 
 *One of `BURN_MCP_TOKEN` or `BURN_SUPABASE_TOKEN` required.
 
+## Transports
+
+This server ships two transports from the same tool set:
+
+| Transport | Entry | Who it's for |
+|---|---|---|
+| **Streamable HTTP** (`src/http.ts` → `api/mcp.ts`) | Remote server (Vercel Edge) | Most users — paste one URL, done |
+| **stdio** (`src/index.ts`) | `npx burn-mcp-server` | Offline / privacy-first users |
+
+### Self-hosting the HTTP server
+
+```bash
+git clone https://github.com/Fisher521/burn-mcp-server
+cd burn-mcp-server
+npm install
+npm run build:http
+PORT=3791 node dist/http.mjs
+# test:
+curl -sS -X POST http://localhost:3791 \
+  -H "Authorization: Bearer <YOUR_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
+```
+
+Or deploy to Vercel (one-click): `vercel --prod` in repo root. Config is in `vercel.json`.
+
 ## Security
 
 - Token scoped to your data only (Row Level Security)

package/api/health.mjs

@@ -0,0 +1,7 @@
+export const config = { runtime: 'edge' }
+export default async function handler(req) {
+  return new Response(JSON.stringify({ ok: true, url: req.url, method: req.method, runtime: 'edge' }), {
+    status: 200,
+    headers: { 'content-type': 'application/json' },
+  })
+}