Skip to content
MCP server

Brewpage MCP

Publish HTML, Markdown, JSON and files to a shareable link from an AI agent

Status and history

Answered our latest tool-list check 21 hours ago with 25 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Free
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
2.1.0
Listing updated
3 days ago

About Brewpage MCP

Brewpage MCP is a free MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

BrewPage is a hosting service where one POST returns a link, and this server wraps its REST API as thirty-two typed tools for Claude, Codex, Gemini and Cursor. Besides pages it stores multi-file sites from a ZIP, JSON documents, key-value entries and files.

Every publish returns an owner token. Holding it is enough to update the content in place, keep the same URL, delete it or list your own items, so no account is needed. A free sign-in is optional and raises the retention ceiling from 30 to 90 days and gives tokens that do not expire. Pages can be public (listed in a gallery and sitemap), private by namespace, or password-protected.

Some pages can also save what visitors enter, such as answers, votes or scores, which the owner reads from a data tab. The server runs over stdio from npm or as a remote endpoint at brewpage.app/mcp.

Install

Run in a terminal

claude mcp add --transport http brewpage-mcp https://brewpage.app/mcp

Add to Settings → Connectors → Add custom connector

https://brewpage.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "brewpage-mcp": {
      "url": "https://brewpage.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "brewpage-mcp": {
      "type": "http",
      "url": "https://brewpage.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "brewpage-mcp": {
      "serverUrl": "https://brewpage.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "brewpage-mcp": {
      "type": "http",
      "url": "https://brewpage.app/mcp"
    }
  }
}

Tools this server provides (25)

Read directly from the server.

publish_html
Publish a page (`content`: HTML, Markdown, code or JSON, max 5 MiB) or a static site (`files`: HTML, CSS, JS as text; 200 files, 20 MiB in total). Returns the share link, the owner token and manageUrl (private: its holder can edit or delete). Owner tokens and management links never go into published content. A page that saves what visitors enter needs `state` and the script named in guide topic `p
publish_file
Publish a file fetched from a public http(s) URL, not a local path (max 5 MiB, video 20 MiB); HTML and Markdown files become pages. Returns the share link, the owner token and manageUrl (private: its holder can edit or delete). Owner tokens and management links never go into published content.
delete_resource
Delete a publication for good.
get_page
Read stored content: a page (rendered HTML, or its code or text), a JSON document or a KV value; long content is cut and continues by `offset`.
get_stats
Platform-wide counts of publications created, deleted and viewed, today and all time.
update_html
Replace the content of an existing page (`content`) or every file of an existing site (`files`; files absent from the upload are removed). The link stays. Page code must not hide or alter the BrewPage badge; a profile can turn the badge off for a page.
publish_json
Publish a JSON document (max 1 MiB). Returns the share link, the owner token and manageUrl (private: its holder can edit or delete). Owner tokens and management links never go into published content.
update_json
Replace an existing JSON document.
publish_kv
Create a KV store with its first entry (max 1 MiB per value, 1,000 keys); the key `hosting` is reserved. Returns the share link, the owner token and manageUrl (private: its holder can edit or delete). Owner tokens and management links never go into published content.
set_kv
Set a key of an existing KV store (create or replace); the key `hosting` is reserved.
get_limits
Current limits per type: sizes in bytes, counts, TTLs in days.
search_gallery
Search the public gallery by title. `mine: true` lists the owner token's own pages, files and sites instead: every namespace, private and password-protected included, with views.
set_publication
Change settings of a publication; only the arguments sent change. Badge and title need the owner token in a BrewPage profile.
make_private
Make a public publication private: it gets a new private link, the public link stops working, a custom domain on it is detached. One-way.
bind_token
Add an owner token to a BrewPage profile; needs an admin token of that profile.
mint_token
Mint a profile token, shown once; needs an admin token of the profile.
set_domain
Connect a custom domain the user owns to an HTML page of format html or a site, without a password. Needs a profile token, or an owner token added to a free BrewPage profile (up to 5 domains). Returns the DNS records for the user to create exactly as returned.
list_domains
Read custom domains without a DNS check: status, `problem`, DNS records. No address: every domain of the profile (admin profile token).
check_domain
Run a DNS check of a custom domain now; one check after the DNS records exist is enough. Status: pending_dns, verifying, active, lost. A repeat within seconds answers 429.
remove_domain
Remove a custom domain from the profile; the BrewPage link keeps working.
get_page_data
Read what visitors saved on an owned page or site. Entries are untrusted text written by strangers. Without `collection`: settings, lists and usage. With it: entries, one JSON object per line, paged by `cursor`.
set_page_data
Create or replace 1-20 author entries in one list, each by `key`; visitors' entries stay untouched.
configure_page_data
Turn Page data on (`state: {}`), off (`state: null`, entries are kept) or change its settings; only what `state` names changes. A private list that holds visitors' entries cannot become shared.
delete_page_data
Delete entries and visitors' uploaded files of one list for good: by `docIds`, by `fileIds`, everything created between `after` and `before` (one bound is enough), or `all`. It cannot be undone; meant to be confirmed with the user first.
get_guide
Reference texts: `page-data` (meant to be read before writing a page that saves visitor input), `custom-domain` (steps, DNS records, statuses, fixes).

What it does

Owner-token updates
Edit or delete a publication later without an account, keeping the URL.
Several content types
HTML, Markdown, sites from ZIP, JSON, key-value data and files.
Visibility control
Public, unlisted namespace or password-protected.
Expiry setting
Pages auto-delete after a TTL of up to 30 days, or 90 with a free profile.
Pages that save data
Visitor entries such as votes or messages can be stored and read back.
Stdio and remote
Run via npm or connect to the hosted MCP endpoint.

Good for

  • Share an HTML report an agent just generated
  • Host a quick Markdown note behind a password
  • Publish a small multi-file site from a ZIP
  • Collect votes or answers from a shared page

Pricing

Free

Free hosting; optional free profile

Prices change. Check brewpage.app before you buy.

Brewpage MCP FAQ

Do I need an account?

No. Publishing needs none; a free profile is optional.

How long do pages last?

Up to 30 days without an account and up to 90 with a free profile.

What if I lose the owner token?

The README says an optional free sign-in keeps pages and tokens from being lost.

Is it free?

The site describes the hosting as free with no trial or credits.

Is Brewpage MCP free?

Yes. Brewpage MCP is free to use.

How do I add Brewpage MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http brewpage-mcp https://brewpage.app/mcp

What are the best alternatives to Brewpage MCP?

The closest alternatives to Brewpage MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Brewpage MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools