Skip to content
Bonfire Docs

Developer reference · REST · MCP · CLI

API, MCP & CLI

Pilot your community from anything that speaks HTTP — including Claude. Three coordinated layers backed by a single tool catalog: generate a key, install the connector, run the CLI, or curl the REST API.

9/9 cross-tenant isolation tests passingAPI keys SHA-256 hashed, scoped, soft-revocablePer-key rate limits up to 1,000 req/min
Native MCP server

Pilot from Claude

Install the connector once, then ask Claude in plain English ("post the launch update to #news pinned"). Claude calls the 18 community tools directly. The first community SaaS that works this way.

MCP endpoint
https://onbonfire.com/api/mcp
Add to Claude.ai
CLI for ops & CI/CD

Community-as-code

Version your channels, modules, members in a YAML file. Apply with one command. Ideal for agencies running many communities or DevOps teams that want auditable infrastructure.

install
npm i -g https://onbonfire.com/cli/onbonfire-cli-0.1.0.tgz
CLI reference
REST API + OpenAPI 3.1

Build anything

Stable, versioned, OpenAPI-documented. Connect your CRM, billing, or courses platform. Bearer auth, scoped keys, rate-limit headers, every error has a code.

sanity check
curl -H "Authorization: Bearer bf_live_…" https://onbonfire.com/api/v1/me
See endpoints below

All endpoints

82 endpoints across 37 areas — generated from the route handlers.

Public API (v1) · 5

GETPOST
/api/v1/channels
GETPOST
/api/v1/channels/{id}/messages
GET
/api/v1/me
GET
/api/v1/members
GETPOST
/api/v1/spaces

Admin · 15

GET
/api/admin/copilot/audit
GETPOSTDELETE
/api/admin/domain
POST
/api/admin/domain/connect
POST
/api/admin/domain/disconnect
GET
/api/admin/domain/verify
PATCH
/api/admin/domain/white-label
POST
/api/admin/grant-premium
GETPATCH
/api/admin/marketplace/claims
GETPATCH
/api/admin/modules
GETPOSTPATCH
/api/admin/owner-setup
GETPATCH
/api/admin/patron/perks
GETPOST
/api/admin/patron/requests
GETPOSTDELETE
/api/admin/payment-settings
GETPOST
/api/admin/sovereignty/delete
GETPOST
/api/admin/sovereignty/export

affiliate · 2

GET
/api/affiliate/me
GET
/api/affiliate/track

AI · 3

POST
/api/ai/extract-knowledge
POSTPATCH
/api/ai/matchmaking
POST
/api/ai/search-knowledge

Auth · 2

GETPOST
/api/auth/logout
GET
/api/auth/post-login-route

contribution · 1

POST
/api/contribution/recalc

AI Copilot · 2

GET
/api/copilot/conversations
GETPOST
/api/copilot/stream

events · 1

POSTPATCH
/api/events/{id}/live

forex-events · 1

GET
/api/forex-events

founder-spots · 1

GETPOST
/api/founder-spots

freemius · 1

POST
/api/freemius/sandbox-token

gdpr · 2

DELETE
/api/gdpr/delete
GET
/api/gdpr/export

global-admin · 1

GETPATCH
/api/global-admin/patron-requests

health · 1

GET
/api/health

import · 5

POST
/api/import/dry-run/approve
POST
/api/import/dry-run/reject
POST
/api/import/intake
GET
/api/import/jobs/{jobId}
GET
/api/import/stream/{jobId}

Internal · 3

GETPOST
/api/internal/api-keys
DELETE
/api/internal/api-keys/{id}
GET
/api/internal/caddy-ask

invitations · 1

POST
/api/invitations/accept

journal · 4

GETPOST
/api/journal/ai-review
POST
/api/journal/import
POST
/api/journal/share
POST
/api/journal/sync

landing-chat · 1

GETPOST
/api/landing-chat

marketplace · 4

POST
/api/marketplace/{slug}/claim
GETPOST
/api/marketplace/{slug}/reviews
GETPOST
/api/marketplace/listings
GETPATCH
/api/marketplace/listings/{slug}

MCP · 1

GETPOST
/api/mcp

member-checkout · 1

POST
/api/member-checkout

milestone-card · 1

GET
/api/milestone-card

Notifications · 4

POST
/api/notifications/push/send
POST
/api/notifications/push/subscribe
POST
/api/notifications/push/test
POST
/api/notifications/push/unsubscribe

openapi.json · 1

GET
/api/openapi.json

patrons · 1

GET
/api/patrons

paypal · 5

POSTOPTIONS
/api/paypal/activate
POST
/api/paypal/capture-order
GETOPTIONS
/api/paypal/client-token
POSTOPTIONS
/api/paypal/create-order
POSTOPTIONS
/api/paypal/create-subscription

realtime · 1

POST
/api/realtime/broadcast

referral · 1

POST
/api/referral/qualify

sentry-test · 1

GET
/api/sentry-test

subscription · 1

POST
/api/subscription/cancel

tenants · 1

POST
/api/tenants

test · 1

POST
/api/test/set-session

upload · 1

POST
/api/upload

video · 1

POST
/api/video/transcribe

webhook · 1

POST
/api/webhook/signal

Webhooks · 3

POST
/api/webhooks/freemius
POST
/api/webhooks/paypal
POST
/api/webhooks/stripe-member

Interactive reference