Is Brewpage Openapi free?

Yes, Brewpage Openapi is free to use.

How do I install Brewpage Openapi?

Brewpage Openapi is a local plugin. Install it using npm package: brewpage-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Brewpage Openapi need?

Brewpage Openapi requires the following credentials or environment variables: BREWPAGE_URL. You can find setup instructions on the server detail page.

What AI apps work with Brewpage Openapi?

Brewpage Openapi uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Brewpage Openapi MCP Server

by Kochetkov Ma

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

Publish HTML, Markdown, KV, JSON, and files to brewpage.app from AI assistants. No signup.

About

Publish HTML, Markdown, KV, JSON, and files to brewpage.app from AI assistants. No signup.

Security Report

4.8

Use Caution4.8High Risk

The brewpage-mcp MCP server is a well-structured Node.js application for publishing content to the BrewPage API. It has no critical vulnerabilities, malicious patterns, or dangerous credential handling. Authentication is API-based (owner tokens passed as headers), permissions are narrowly scoped to the BrewPage backend, and code quality is solid. Minor concerns around input validation and error handling do not significantly impact security. Supply chain analysis found 8 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue (1 critical, 0 high severity).

8 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

What You'll Need

Set these up before or after installing:

Override API base URL. Defaults to https://brewpage.app.Optional

Environment variable: BREWPAGE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-kochetkov-ma-brewpage-mcp": {
      "env": {
        "BREWPAGE_URL": "your-brewpage-url-here"
      },
      "args": [
        "-y",
        "brewpage-docs"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

BrewPage API -- Open Source Public Layer

This repository is the open-source public layer of BrewPage -- a proprietary HTML/KV/JSON/file hosting platform. The backend, frontend, and infrastructure remain closed-source.

Docs: https://kochetkov-ma.github.io/brewpage-openapi/ | API Reference: https://kochetkov-ma.github.io/brewpage-openapi/api-reference/

What's Open Here
What's Proprietary
Quick Start
API Features
API Examples
API Reference
MCP Server
Documentation
Project Structure
Links
License

What's Open Here

Component	Description
OpenAPI 3.1 spec	Complete API contract for all public endpoints (YAML + JSON)
Interactive docs	Astro + Scalar documentation site (GitHub Pages)
MCP server	`brewpage-mcp` -- Claude Desktop/Code integration (6 tools)
Wiki	Code snippets, cheatsheet, tips & tricks
Release notes	Changelog for API and public tooling

What's Proprietary

Component	Description
Backend	Spring Boot + Kotlin REST API
Frontend	HTML/CSS/JS + Caddy reverse proxy
Infrastructure	VPS deployment, CI/CD pipelines
E2E test suite	Playwright + Testcontainers

Quick Start

Web UI

Open brewpage.app -> Drop a file or paste HTML -> Publish -> Get a shareable link.

Claude Skill

/brewpage "Hello, world!"

Publish content instantly via the brewcode plugin skill.

MCP Server

Add brewpage-mcp to your Claude config:

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

Then ask Claude: "Publish this HTML to BrewPage".

API

curl -X POST https://brewpage.app/api/html \
  -H "Content-Type: application/json" \
  -d '{"content": "<h1>Hello, world!</h1>"}'

Response:

{
  "id": "aBcDeFgHiJ",
  "namespace": "public",
  "link": "https://brewpage.app/public/aBcDeFgHiJ",
  "ownerLink": "https://brewpage.app/api/html/public/aBcDeFgHiJ",
  "ownerToken": "your-secret-token",
  "expiresAt": "2026-04-05T12:00:00Z",
  "sizeBytes": 22
}

API Features

BrewPage is a content hosting platform. Publish and share:

Resource	Description	Limits
HTML pages	Raw HTML or Markdown with instant short URLs	5 MB, TTL 30--365d
Key-value store	Named key-value pairs grouped in namespaces	1,000 keys/namespace
JSON documents	Store and retrieve arbitrary JSON with collection management	1 MB, 10,000 docs/collection
Files	Upload files with automatic MIME detection and inline preview	5 MB, 1,000 files/namespace
Sites	Multi-file HTML sites via ZIP or individual files	5 MB/file, 1,000 files/site, TTL 1--30d

Every resource gets a short URL (brewpage.app/{ns}/{id}), optional password protection, configurable TTL, and tagging. Public content appears in a browsable gallery with search.

API Examples

Get platform stats:

curl https://brewpage.app/api/stats

Publish Markdown:

curl -X POST "https://brewpage.app/api/html?format=markdown" \
  -H "Content-Type: application/json" \
  -d '{"content": "# My Document\n\nHello **world**"}'

Store a JSON document:

curl -X POST https://brewpage.app/api/json \
  -H "Content-Type: application/json" \
  -d '{"name": "config", "version": 1}'

Upload a site (individual files):

curl -X POST "https://brewpage.app/api/sites" \
  -F "files=@index.html;type=text/html" \
  -F "files=@style.css;type=text/css" \
  -F "paths=index.html" \
  -F "paths=style.css"

Upload a site (ZIP archive):

curl -X POST "https://brewpage.app/api/sites" \
  -F "archive=@site.zip;type=application/zip"

API Reference

Interactive docs -- kochetkov-ma.github.io/brewpage-openapi
API Reference (Scalar) -- kochetkov-ma.github.io/brewpage-openapi/api-reference
OpenAPI spec (YAML) -- openapi/openapi.yaml
OpenAPI spec (JSON) -- openapi/openapi.json

Endpoints

Tag	Description
HTML	Publish, retrieve, update, delete HTML/Markdown pages
KV	Key-value store CRUD (get, set, list, delete keys)
JSON	JSON document CRUD with collection listing
Files	File upload, download, list, delete
Sites	Multi-file site upload (ZIP or files), info, serve, delete
Gallery	Browse public content with search and pagination
Stats	Platform-wide usage statistics
Short Links	URL shortener for published content
SEO	Sitemap and robots.txt endpoints

MCP Server

The brewpage-mcp package provides a Model Context Protocol server with 6 tools for AI-assisted content publishing. See mcp-server/README.md for full documentation.

Tool	Description
`publish_html`	Publish HTML or Markdown content
`publish_file`	Upload a file from URL
`publish_site`	Publish a multi-file HTML site
`delete_resource`	Delete any resource by owner token
`get_page`	Fetch a published HTML page
`get_stats`	Get platform-wide statistics

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

Add to settings.json:

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

Documentation

Full documentation is deployed to GitHub Pages:

kochetkov-ma.github.io/brewpage-openapi

The docs site includes getting started guides, API examples, and MCP server usage instructions.

Project Structure

brewpage-openapi/
  openapi/
    openapi.json          # OpenAPI 3.1 spec (JSON)
    openapi.yaml          # OpenAPI 3.1 spec (YAML)
  docs-site/              # Astro documentation site
    src/
      pages/              # Documentation pages
      components/         # Scalar API reference
  mcp-server/             # MCP server (brewpage-mcp)
    src/
      index.ts            # Server entry point
      tools/              # MCP tool implementations
  .github/
    workflows/            # CI/CD (docs deploy, releases)
  README.md
  RELEASE-NOTES.md
  LICENSE

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Brewpage Openapi MCP Server

About

Security Report

Findings (12)Action required

Permissions Required

What You'll Need

How to Install

Documentation

BrewPage API -- Open Source Public Layer

Table of Contents

What's Open Here

What's Proprietary

Quick Start

Web UI

Claude Skill

MCP Server

API

API Features

API Examples

API Reference

Endpoints

MCP Server

Claude Desktop

Claude Code

Documentation

Project Structure

Links

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

Google Workspace MCP