# Brewpage MCP

> Brewpage MCP is a free MCP server for files and documents. Publish HTML, Markdown, JSON and files to a shareable link from an AI agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://brewpage.app
- **Repository:** https://github.com/kochetkov-ma/brewpage-openapi
- **MCP Registry name:** io.github.kochetkov-ma/brewpage-mcp
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://brewpage.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "brewpage-mcp": {
      "url": "https://brewpage.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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).

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/brewpage-mcp
