BrewPage

BrewPage is a free, no-registration instant hosting service for HTML pages, Markdown documents, AI-agent artifacts, files, and multi-file static sites. It also offers a namespaced key-value store and a JSON document store. The REST API returns short, shareable HTTPS links (https://brewpage.app/{ns}/{id}) and an owner token used to update or delete content in place. BrewPage is designed to be AI-agent friendly: it provides an MCP server (brewpage-mcp), a Claude Code skill (brewdoc:publish), and a llms.txt manifest, and it requires a self-identifying User-Agent header on every request.

BrewPage publishes 13 APIs on the APIs.io network, including Files API, Gallery API, HTML API, and 10 more. Tagged areas include Hosting, Markdown, HTML, AI Artifacts, and File Hosting.

The BrewPage catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

BrewPage’s developer surface includes documentation, API reference, developer portal, getting-started guide, authentication, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub

52.5/100 developing ▬ flat Agent 41/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreeOpen⚡ Free to try

13 APIs 17 Features 7 Use Cases

HostingMarkdownHTMLAI ArtifactsFile HostingDeveloper Tools

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 52.5/100 · developing

Contract Quality 16.6 / 25

Developer Ergonomics 10.4 / 20

Commercial Clarity 5.8 / 20

Operational Transparency 4.1 / 13

Governance 8.3 / 12

Discoverability 7.4 / 10

Agent readiness — 41/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/brewpage: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 13

Individual APIs this provider publishes, each with its own machine-readable definition.

BrewPage Files API

File hosting up to 5 MB per file, 1000 files per namespace

BrewPage Gallery API

Browse public content from the 'public' namespace without password protection

BrewPage HTML API

HTML page hosting with markdown support

BrewPage JSON API

JSON document store with up to 10,000 docs per collection

BrewPage KV API

Key-Value store with up to 1000 keys per namespace

BrewPage Namespace API

Fresh, collision-free namespace suggestions

BrewPage Owner Check API

Lightweight owner-token probe; never increments views or returns content

BrewPage preview API

OpenGraph metadata for social bots

BrewPage Reports API

Abuse reports for hosted content

BrewPage SEO API

Search engine optimization endpoints

BrewPage Short Links API

Short URL resolver for sharing

BrewPage Sites API

Multi-file HTML site hosting via ZIP or folder upload

BrewPage Stats API

Platform-wide usage statistics

Scroll for all 13

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

BrewPage API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Brewpage Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Brewpage Rate Limits

11 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Brewpage Finops

FINOPS

Features 17

Notable capabilities this provider offers.

Instant HTML Hosting

POST raw HTML or a JSON body to /api/html and receive a 10-char short URL at /{ns}/{id} with no signup.

Markdown Rendering

Pass `format=markdown` to publish Markdown that BrewPage renders to styled HTML at view time.

Multi-File Site Hosting

Upload a ZIP archive or files+paths multipart to /api/sites; entry point auto-detected (index.html preferred); 20 MB / 100 files / 5 MB each.

File Hosting

Upload binary or text files via /api/files (5 MB max). Images, PDFs, video, and audio display inline; ?dl=1 forces download.

Key-Value Store

1000-key namespaced KV stores via /api/kv with per-key PUT/GET/DELETE and per-store enumeration.

JSON Document Store

10,000-document collections via /api/json with PUT-in-place semantics on stable short URLs.

Update In Place

PUT to /api/html, /api/json, and /api/kv replaces content while keeping the short URL — agents can iterate without breaking shared links.

Owner Token Grouping

Save the `ownerToken` returned at creation and reuse it via `X-Owner-Token` to group resources under one owner and scope list endpoints.

Password Protection

Set `X-Password` (min 4 chars) at creation to require the same header (or `?p=...`) for reads; passworded items are excluded from the gallery and sitemap.

Public Gallery

GET /api/gallery surfaces content posted to the default `public` namespace without a password — searchable, social-bot friendly, OG-image generated.

OpenGraph Preview Images

Per-content 1200×630 PNG at /preview/{ns}/{id}.png plus an /preview-html stub for social media unfurlers.

Short Link Resolver

GET /{ns}/{id} returns the hosted content; GET /{ns}/{id}/{sub} resolves sub-paths inside multi-file sites.

Idempotent Owner Re-POST

A byte-identical POST /api/html to `public/` within 24h returns the existing id (X-Existing-Resource header set) so retries do not duplicate gallery entries.

Abuse Reports

POST /api/reports lets readers report inappropriate or harmful content for moderation.

Random Namespace Suggestion

GET /api/namespace/random returns a fresh, collision-free kebab-case namespace suggestion.

Platform Stats

GET /api/stats exposes platform-wide usage statistics; GET /api/sitemap.xml exposes a dynamic sitemap of public content.

AI-Agent Friendly

llms.txt and llms-full.txt manifests, an MCP server, a Claude Code skill, and required identifying User-Agent headers make BrewPage first-class for autonomous agents.

Scroll for all 17

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Brewpage Context

21 classes · 9 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

BrewPage API Rules

5 rules · 3 warnings 2 info

SPECTRAL

BrewPage API Rules

21 rules · 4 errors 14 warnings 3 info

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

BrewPage File

13 properties

JSON SCHEMA

BrewPage HTML Page

14 properties

JSON SCHEMA

BrewPage JSON Document

10 properties

JSON SCHEMA

BrewPage KV Store

9 properties

JSON SCHEMA

BrewPage Multi-File Site

12 properties

JSON SCHEMA

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Brewpage Html Page Structure

0 properties

JSON STRUCTURE

Brewpage Kv Store Structure

0 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Brewpage Create Html Example

2 fields

EXAMPLE

Brewpage Create Markdown Example

2 fields

EXAMPLE

Brewpage Upload File Example

2 fields

EXAMPLE

Brewpage Upload Site Example

2 fields

EXAMPLE

Brewpage Upsert Kv Example

2 fields

EXAMPLE

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Brewpage Domain Security

TLSv1.3 · HSTS

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Brewpage Agentic Access

36 operations · 15 acting

AGENTIC

Use Cases 7

What developers build with this provider.

Share AI-Agent Output

Drop a Markdown report, generated HTML page, or JSON artifact and share a short URL with a teammate or end user.

Iterate On A Stable Link

Use PUT to refine content at the same short URL across multiple agent iterations without breaking previously shared links.

Stand Up A One-Off Microsite

Upload a ZIP of a static site (docs, demo, status page) and get a 30-day-max hosted URL with relative links between files.

Ephemeral File Drop

Send a PDF, image, or archive (≤5 MB) to a recipient who shouldn't need to sign up — URL expires automatically.

Scratch KV Storage For Agents

Use /api/kv as a free, server-side scratchpad for feature flags, session state, or memoized tool outputs (≤1000 keys per store).

Public Knowledge Drop

Post to the default `public` namespace and let the gallery + sitemap + OG image expose your content to search engines and social.

Password-Gated Share

Apply X-Password to a hosted page or file for lightweight access control without user accounts.

Scroll for all 7

Integrations 6

Pre-built integrations with other platforms and tools.

Model Context Protocol (MCP)

Official MCP server `brewpage-mcp` exposes BrewPage to any LLM/agent (Claude, Codex, Gemini, Cursor) via the Model Context Protocol.

Claude Code

Claude Code skill `brewdoc:publish` lets users publish from inside Claude Code via a slash command (claude-brewcode marketplace).

IndexNow

BrewPage submits public content to IndexNow for search engine discovery; PUT-based republish is recommended to preserve quota.

OpenGraph / Social Bots

Every short URL exposes `/preview/{ns}/{id}.png` (1200×630) and a `/preview-html/{ns}/{id}` OG stub for link unfurling.

Prism.js

Client-side syntax highlighting for known code/data file previews (JSON, XML, SVG, HTML, CSS, JS, TS, YAML, TOML, Markdown).

llms.txt

BrewPage publishes a /llms.txt and /llms-full.txt manifest for LLM-friendly discovery of the API surface.

Solutions 4

Packaged solutions this provider offers.

Hosted Web Page

Free HTML/Markdown publishing with short URL, OG images, and password gating.

Hosted Files And Sites

5 MB files and 20 MB multi-file sites with TTL up to 30 days.

Agent State And Documents

KV stores (1000 keys) and JSON collections (10,000 docs) for stateful agent workflows.

AI-Agent Integration

MCP server, Claude Code skill, llms.txt manifests, and identifying User-Agent contract.

Resources

Get Started 3

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

GettingStarted

GettingStarted

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRules

SpectralRules

Vocabulary

Vocabulary

JSONLD

JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

SDKs

SDKs

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Source (apis.yml)

aid: brewpage
url: https://raw.githubusercontent.com/api-evangelist/brewpage/refs/heads/main/apis.yml
name: BrewPage
type: Index
accessModel:
  pricing: free
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Free · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/brewpage.png
description: 'BrewPage is a free, no-registration instant hosting service for HTML pages, Markdown documents, AI-agent artifacts,
  files, and multi-file static sites. It also offers a namespaced key-value store and a JSON document store. The REST API
  returns short, shareable HTTPS links (https://brewpage.app/{ns}/{id}) and an owner token used to update or delete content
  in place. BrewPage is designed to be AI-agent friendly: it provides an MCP server (brewpage-mcp), a Claude Code skill (brewdoc:publish),
  and a llms.txt manifest, and it requires a self-identifying User-Agent header on every request.'
created: '2026-05-16'
modified: '2026-05-19'
specificationVersion: '0.19'
tags:
- Hosting
- Markdown
- HTML
- AI Artifacts
- File Hosting
- Developer Tools
url-source: https://brewpage.app/
apis:
- aid: brewpage:brewpage-files-api
  name: BrewPage Files API
  description: File hosting up to 5 MB per file, 1000 files per namespace
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Files
  properties:
  - type: OpenAPI
    url: openapi/brewpage-files-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-gallery-api
  name: BrewPage Gallery API
  description: Browse public content from the 'public' namespace without password protection
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Gallery
  properties:
  - type: OpenAPI
    url: openapi/brewpage-gallery-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-html-api
  name: BrewPage HTML API
  description: HTML page hosting with markdown support
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - HTML
  properties:
  - type: OpenAPI
    url: openapi/brewpage-html-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-json-api
  name: BrewPage JSON API
  description: JSON document store with up to 10,000 docs per collection
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - JSON
  properties:
  - type: OpenAPI
    url: openapi/brewpage-json-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-kv-api
  name: BrewPage KV API
  description: Key-Value store with up to 1000 keys per namespace
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - KV
  properties:
  - type: OpenAPI
    url: openapi/brewpage-kv-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-namespace-api
  name: BrewPage Namespace API
  description: Fresh, collision-free namespace suggestions
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Namespace
  properties:
  - type: OpenAPI
    url: openapi/brewpage-namespace-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-owner-check-api
  name: BrewPage Owner Check API
  description: Lightweight owner-token probe; never increments views or returns content
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Owner Check
  properties:
  - type: OpenAPI
    url: openapi/brewpage-owner-check-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-preview-api
  name: BrewPage preview API
  description: OpenGraph metadata for social bots
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - preview
  properties:
  - type: OpenAPI
    url: openapi/brewpage-preview-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-reports-api
  name: BrewPage Reports API
  description: Abuse reports for hosted content
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Reports
  properties:
  - type: OpenAPI
    url: openapi/brewpage-reports-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-seo-api
  name: BrewPage SEO API
  description: Search engine optimization endpoints
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - SEO
  properties:
  - type: OpenAPI
    url: openapi/brewpage-seo-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-short-links-api
  name: BrewPage Short Links API
  description: Short URL resolver for sharing
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Short Links
  properties:
  - type: OpenAPI
    url: openapi/brewpage-short-links-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-sites-api
  name: BrewPage Sites API
  description: Multi-file HTML site hosting via ZIP or folder upload
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Sites
  properties:
  - type: OpenAPI
    url: openapi/brewpage-sites-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
- aid: brewpage:brewpage-stats-api
  name: BrewPage Stats API
  description: Platform-wide usage statistics
  humanURL: https://brewpage.app/api
  baseURL: https://brewpage.app
  tags:
  - Stats
  properties:
  - type: OpenAPI
    url: openapi/brewpage-stats-api-openapi.yml
  - type: Documentation
    url: https://brewpage.app/api
  - type: APIReference
    url: https://kochetkov-ma.github.io/brewpage-openapi/
  - type: Authentication
    url: https://brewpage.app/llms-full.txt
  - type: JSONSchema
    url: json-schema/brewpage-html-page-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-file-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-kv-store-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-json-document-schema.json
  - type: JSONSchema
    url: json-schema/brewpage-site-schema.json
  - type: JSONStructure
    url: json-structure/brewpage-html-page-structure.json
  - type: JSONStructure
    url: json-structure/brewpage-kv-store-structure.json
  - type: Examples
    url: examples/brewpage-create-html-example.json
  - type: Examples
    url: examples/brewpage-create-markdown-example.json
  - type: Examples
    url: examples/brewpage-upload-file-example.json
  - type: Examples
    url: examples/brewpage-upload-site-example.json
  - type: Examples
    url: examples/brewpage-upsert-kv-example.json
common:
- type: AgenticAccess
  url: agentic-access/brewpage-agentic-access.yml
- type: DomainSecurity
  url: security/brewpage-domain-security.yml
- type: Documentation
  url: https://brewpage.app/api
- type: APIReference
  url: https://kochetkov-ma.github.io/brewpage-openapi/
- type: Portal
  url: https://brewpage.app/
- type: GettingStarted
  url: https://brewpage.app/llms.txt
- type: GettingStarted
  url: https://brewpage.app/llms.txt
- type: Authentication
  url: https://brewpage.app/llms-full.txt
- type: SDKs
  url: https://www.npmjs.com/package/brewpage-mcp
- type: Plans
  url: plans/brewpage-plans-pricing.yml
- type: RateLimits
  url: rate-limits/brewpage-rate-limits.yml
- type: FinOps
  url: finops/brewpage-finops.yml
- type: Integrations
  data:
  - name: Model Context Protocol (MCP)
    description: Official MCP server `brewpage-mcp` exposes BrewPage to any LLM/agent (Claude, Codex, Gemini, Cursor) via
      the Model Context Protocol.
  - name: Claude Code
    description: Claude Code skill `brewdoc:publish` lets users publish from inside Claude Code via a slash command (claude-brewcode
      marketplace).
  - name: IndexNow
    description: BrewPage submits public content to IndexNow for search engine discovery; PUT-based republish is recommended
      to preserve quota.
  - name: OpenGraph / Social Bots
    description: Every short URL exposes `/preview/{ns}/{id}.png` (1200×630) and a `/preview-html/{ns}/{id}` OG stub for link
      unfurling.
  - name: Prism.js
    description: Client-side syntax highlighting for known code/data file previews (JSON, XML, SVG, HTML, CSS, JS, TS, YAML,
      TOML, Markdown).
  - name: llms.txt
    description: BrewPage publishes a /llms.txt and /llms-full.txt manifest for LLM-friendly discovery of the API surface.
  sources:
  - https://brewpage.app/llms.txt
  - https://brewpage.app/llms-full.txt
  updated: '2026-05-16'
- type: SpectralRules
  url: rules/brewpage-rules.yml
- type: Vocabulary
  url: vocabulary/brewpage-vocabulary.yml
- type: JSONLD
  url: json-ld/brewpage-context.jsonld
- type: Features
  data:
  - name: Instant HTML Hosting
    description: POST raw HTML or a JSON body to /api/html and receive a 10-char short URL at /{ns}/{id} with no signup.
  - name: Markdown Rendering
    description: Pass `format=markdown` to publish Markdown that BrewPage renders to styled HTML at view time.
  - name: Multi-File Site Hosting
    description: Upload a ZIP archive or files+paths multipart to /api/sites; entry point auto-detected (index.html preferred);
      20 MB / 100 files / 5 MB each.
  - name: File Hosting
    description: Upload binary or text files via /api/files (5 MB max). Images, PDFs, video, and audio display inline; ?dl=1
      forces download.
  - name: Key-Value Store
    description: 1000-key namespaced KV stores via /api/kv with per-key PUT/GET/DELETE and per-store enumeration.
  - name: JSON Document Store
    description: 10,000-document collections via /api/json with PUT-in-place semantics on stable short URLs.
  - name: Update In Place
    description: PUT to /api/html, /api/json, and /api/kv replaces content while keeping the short URL — agents can iterate
      without breaking shared links.
  - name: Owner Token Grouping
    description: Save the `ownerToken` returned at creation and reuse it via `X-Owner-Token` to group resources under one
      owner and scope list endpoints.
  - name: Password Protection
    description: Set `X-Password` (min 4 chars) at creation to require the same header (or `?p=...`) for reads; passworded
      items are excluded from the gallery and sitemap.
  - name: Public Gallery
    description: GET /api/gallery surfaces content posted to the default `public` namespace without a password — searchable,
      social-bot friendly, OG-image generated.
  - name: OpenGraph Preview Images
    description: Per-content 1200×630 PNG at /preview/{ns}/{id}.png plus an /preview-html stub for social media unfurlers.
  - name: Short Link Resolver
    description: GET /{ns}/{id} returns the hosted content; GET /{ns}/{id}/{sub} resolves sub-paths inside multi-file sites.
  - name: Idempotent Owner Re-POST
    description: A byte-identical POST /api/html to `public/` within 24h returns the existing id (X-Existing-Resource header
      set) so retries do not duplicate gallery entries.
  - name: Abuse Reports
    description: POST /api/reports lets readers report inappropriate or harmful content for moderation.
  - name: Random Namespace Suggestion
    description: GET /api/namespace/random returns a fresh, collision-free kebab-case namespace suggestion.
  - name: Platform Stats
    description: GET /api/stats exposes platform-wide usage statistics; GET /api/sitemap.xml exposes a dynamic sitemap of
      public content.
  - name: AI-Agent Friendly
    description: llms.txt and llms-full.txt manifests, an MCP server, a Claude Code skill, and required identifying User-Agent
      headers make BrewPage first-class for autonomous agents.
  sources:
  - https://brewpage.app/
  - https://brewpage.app/llms.txt
  - https://brewpage.app/llms-full.txt
  - https://brewpage.app/api/openapi.yaml
  updated: '2026-05-16'
- type: UseCases
  data:
  - name: Share AI-Agent Output
    description: Drop a Markdown report, generated HTML page, or JSON artifact and share a short URL with a teammate or end
      user.
  - name: Iterate On A Stable Link
    description: Use PUT to refine content at the same short URL across multiple agent iterations without breaking previously
      shared links.
  - name: Stand Up A One-Off Microsite
    description: Upload a ZIP of a static site (docs, demo, status page) and get a 30-day-max hosted URL with relative links
      between files.
  - name: Ephemeral File Drop
    description: Send a PDF, image, or archive (≤5 MB) to a recipient who shouldn't need to sign up — URL expires automatically.
  - name: Scratch KV Storage For Agents
    description: Use /api/kv as a free, server-side scratchpad for feature flags, session state, or memoized tool outputs
      (≤1000 keys per store).
  - name: Public Knowledge Drop
    description: Post to the default `public` namespace and let the gallery + sitemap + OG image expose your content to search
      engines and social.
  - name: Password-Gated Share
    description: Apply X-Password to a hosted page or file for lightweight access control without user accounts.
  sources:
  - https://brewpage.app/
  - https://brewpage.app/llms.txt
  updated: '2026-05-16'
- type: Solutions
  data:
  - name: Hosted Web Page
    description: Free HTML/Markdown publishing with short URL, OG images, and password gating.
  - name: Hosted Files And Sites
    description: 5 MB files and 20 MB multi-file sites with TTL up to 30 days.
  - name: Agent State And Documents
    description: KV stores (1000 keys) and JSON collections (10,000 docs) for stateful agent workflows.
  - name: AI-Agent Integration
    description: MCP server, Claude Code skill, llms.txt manifests, and identifying User-Agent contract.
  sources:
  - https://brewpage.app/
  - https://brewpage.app/llms-full.txt
  updated: '2026-05-16'
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  url: https://apievangelist.com