brewpage-mcp

MCP server for BrewPage -- publish and manage HTML, KV, JSON, and file content directly from AI assistants.

Quick Start

npx brewpage-mcp

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "brewpage": {
      "command": "npx",
      "args": ["-y", "brewpage-mcp"]
    }
  }
}

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "brewpage": {
      "command": "npx",
      "args": ["-y", "brewpage-mcp"]
    }
  }
}

Global Install

npm install -g brewpage-mcp
brewpage-mcp

Tools

Tool	Description
publish_html	Publish HTML or Markdown content -> URL + owner token
publish_file	Upload file from URL -> URL + owner token
delete_resource	Delete resource with owner token
get_page	Fetch published page content
get_stats	Platform-wide statistics

Usage Examples

Ask Claude:

• "Publish this HTML to BrewPage" -> Creates a page, returns public URL
• "Create a BrewPage with my meeting notes in Markdown" -> Markdown page
• "Upload this image to BrewPage" -> File upload
• "Delete my page demo/abc123, token tok_xyz" -> Deletes resource
• "Show BrewPage stats" -> Platform statistics

Owner Token

Every publish response includes an owner token -- the only way to update or delete your content. Save it! It cannot be recovered.

Configuration

Variable	Default	Description
BREWPAGE_URL	https://brewpage.app	API base URL

What is BrewPage?

BrewPage is a free content hosting platform. No signup required.

• HTML/Markdown pages with instant short URLs
• Key-value store (1,000 keys per store)
• JSON documents (10,000 per collection)
• File hosting (5 MB per file)

Both brewpage.app and brewdata.app serve the same API.

Links

• brewpage.app -- Live platform
• API Documentation -- Interactive docs
• API Reference -- Scalar API explorer
• OpenAPI Spec -- Full specification
• Claude Skill -- /brewpage command
• Brewcode Plugin -- Claude Code plugin suite

Changelog

1.4.0 — 2026-05-12

• Sync to spec 1.31.0 — adds raw text/* and application/octet-stream variants on POST /api/html; PUT mirror; 422 with supportedTypes.

License

MIT