brewpage-mcp

by kochetkov-ma

309 downloads

Not rated

GitHub Website

About

Publish HTML, Markdown, KV, JSON, and files to brewpage.app from AI assistants. 5 tools, stdio, no signup. Returns public short URL + owner token per artifact.

Details

Author: kochetkov-ma
Downloads: 309
Categories: File Management, Other, Web Scraping

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name brewpage-mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Add brewpage-mcp to your MCP client configuration (e.g., mcpServers in JSON) with npx -y brewpage-mcp. No API key or signup required. Optionally set the BREWPAGE_URL environment variable to override the default https://brewpage.app. Then ask your AI assistant to publish content, upload files, fetch pages, or delete resources using the provided owner token.

`publish_html`

Publish HTML or Markdown content to BrewPage. Returns a public URL and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar).

`publish_file`

Upload a file to BrewPage via URL. Returns a public URL and owner token.

`delete_resource`

Delete a BrewPage resource (HTML page, KV store, JSON collection, or file) using the owner token.

`get_page`

Fetch a published BrewPage HTML page content by namespace and ID.

`get_stats`

Get BrewPage platform-wide usage statistics including page count, file count, and storage usage. Counts use disjoint split: alive_public + alive_private + deleted == total. Optional `tz` shifts the 'today' boundary to the given IANA zone (default UTC).

`publish_site`

Publish an HTML site to BrewPage. Single-page: pass `entryContent`. Multi-page: pass `files` (array of `{path, content}`). Optional `entry` overrides default `index.html`.

`republish_site`

Republish (full-replace) an existing multi-file BrewPage site in place at the SAME URL/ID. Requires owner token. The uploaded bundle becomes the complete new file set — files absent from it are removed, new files added, matching files overwritten. Single-page: pass `entryContent`. Multi-page: pass `files` (array of `{path, content}`). Optional `entry` overrides the default `index.html`.

`update_html`

Update an existing BrewPage HTML/Markdown page. Requires owner token. Returns the updated page metadata.

`publish_json`

Publish a JSON document to BrewPage. Accepts a JSON object, array, or a JSON-encoded string. Returns a public URL and owner token.

`get_json`

Fetch a published BrewPage JSON document by namespace and ID.

`update_json`

Update an existing BrewPage JSON document. Requires owner token. Accepts a JSON object, array, or a JSON-encoded string.

`publish_kv`

Publish a key/value entry to BrewPage. Creates a KV store; the entry is addressed by (namespace, id, key). Returns a public URL and owner token.

`set_kv`

Set or update a key in an existing BrewPage KV store. Requires owner token.

`get_kv`

Fetch a value from a BrewPage KV store by namespace, ID, and key.

`search_gallery`

Search the BrewPage public gallery. Optional filters: text query, pagination, sort, and 'mine' (owner-scoped, requires owner token).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

BrewPage MCP

MCP server for BrewPage — a free, no-signup content hosting platform. Lets Claude, Cursor, Cline, and any MCP client publish and manage HTML, Markdown, KV entries, JSON documents, and files directly, returning a public short URL and an owner token per artifact. ## Tools (5) | Tool | What it does | |------|--------------| | publish_html | Publish HTML or Markdown → public short URL + owner token | | publish_file | Upload a file (≤5 MB, 20 MB video, 5 MB audio) → public URL | | get_page | Fetch previously published content | | delete_resource | Delete by owner token | | get_stats | Platform-wide usage statistics | ## Install ```json { "mcpServers": { "brewpage": { "command": "npx", "args": ["-y", "brewpage-mcp"] } } } Zero config — BREWPAGE_URL (optional) overrides the default https://brewpage.app. Usage examples Ask your AI assistant: - "Publish this HTML to BrewPage" → returns public URL - "Create a BrewPage with my meeting notes in Markdown" - "Upload this image to BrewPage" - "Delete my page demo/abc123, owner token tok_xyz" Every publish returns an owner token — the only way to update or delete your content. Save it, it can't be recovered. Links - Live platform: https://brewpage.app - npm: brewpage-mcp (https://www.npmjs.com/package/brewpage-mcp) (v1.3.2, MIT) - Source: https://github.com/kochetkov-ma/brewpage-openapi/tree/main/mcp-server - Official MCP Registry: io.github.kochetkov-ma/brewpage-mcp - OpenAPI docs: https://kochetkov-ma.github.io/brewpage-openapi/ Limits ┌──────────┬──────────────────────────────┐ │ Resource │ Limit │ ├──────────┼──────────────────────────────┤ │ HTML │ 5 MB, TTL 15d / max 30d │ ├──────────┼──────────────────────────────┤ │ KV value │ 1 MB, 1000 keys/namespace │ ├──────────┼──────────────────────────────┤ │ JSON doc │ 1 MB, 10 000 docs/collection │ ├──────────┼──────────────────────────────┤ │ File │ 5 MB (video 20 MB) │ └──────────┴──────────────────────────────┘ MIT licensed.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

publish_html

publish_file

delete_resource

get_page

get_stats

publish_site

republish_site

update_html

publish_json

get_json

update_json

publish_kv

set_kv

get_kv

search_gallery

Claude Desktop / Cursor

McpServers

BrewPage MCP

Install

More like this

@mendableai/firecrawl Mcp Server

Sequential Thinking

Filesystem

EverArt

Google Drive

Puppeteer

`publish_html`

`publish_file`

`delete_resource`

`get_page`

`get_stats`

`publish_site`

`republish_site`

`update_html`

`publish_json`

`get_json`

`update_json`

`publish_kv`

`set_kv`

`get_kv`

`search_gallery`