Developer FAQ
Building on top of Bonfire programmatically.
Where do I get an API key?
In Admin → API Keys. Generate a key, then send it as a Bearer token: Authorization: Bearer <key>.
What's the API base URL?
The public REST API lives under /api/v1. All endpoints are authenticated with your Bearer key.
How do I get notified of events?
Register webhooks to receive event payloads (new members, messages, payments, and more) at your endpoint.
Is there an MCP server?
Yes. Bonfire ships a native MCP server at /api/mcp, so you can pilot your community from Claude using the same authenticated key.
Can I manage my community as code?
Yes. The CLI supports community-as-code: define spaces, channels, and configuration in YAML and apply it. Great for repeatable, version-controlled setups.
How does this relate to the AI Owner Copilot?
The AI Owner Copilot is the in-app, chat-driven admin assistant (18 typed actions, confirmation gates, audit log). The REST API, webhooks, MCP, and CLI are the programmatic surfaces for your own code and tools.
What auth methods exist for sign-in?
End users sign in with email or Google. There is no SAML/SSO. API access uses Bearer keys, separate from user sign-in.
Related
- Authenticate with the REST API
- Subscribe to webhooks
- Use the CLI for community-as-code
FAQ
Can I rotate or revoke a key? Yes, manage keys in Admin → API Keys; revoke a key to invalidate it immediately.
Does the MCP server use the same key?
Yes, /api/mcp authenticates with your API key.
Is the API versioned?
Yes, the current version is /api/v1.
Can the CLI create paid tiers or modules? The CLI focuses on community structure as YAML; use the Admin panel or AI Copilot for monetization and module toggles.