Documentation Index
Fetch the complete documentation index at: https://docs.brama.work/llms.txt
Use this file to discover all available pages before exploring further.
Stack
| Layer | Tool | Repo |
|---|---|---|
MCP server (api.brama.work) | Go 1.26 + modelcontextprotocol/go-sdk v1.5.0 | bystrovagency/brama-mcp |
Admin (app.brama.work) | Next.js 15 + Supabase Auth + Tailwind v4 | bystrovagency/brama-app (apps/admin) |
Landing (brama.work) | Next.js static | bystrovagency/brama-app (apps/marketing) |
| Docs (this site) | Mintlify | bystrovagency/brama-docs |
| Auth + DB | Supabase Postgres з RLS | managed |
| Monitoring | Sentry (3 projects: brama-mcp, brama-app, brama-docs) | managed |
| Deploy | DigitalOcean Apps (MCP) + Vercel (frontend) | managed |
Request flow
Components
MCP Server (brama-mcp)
Go HTTP server що:
- Listens on
api.brama.work(DigitalOcean Apps, regionfra) - Implements MCP protocol через
modelcontextprotocol/go-sdk - Routes incoming tool calls до integration handlers per vendor
- Logs breadcrumbs у Sentry для audit trail
- Health check на
/health
Integration SDKs ({vendor}-sdk)
Per-vendor Go SDK у окремому repo (наприклад bystrovagency/ringostat-sdk).
Pattern parity з нашими existing SDK (monobank-sdk, novapost-sdk):
- Thin wrapper над vendor API
- OAuth flow + token refresh
- Typed errors + rate limit handling
- Context-aware методи
Tenant Admin (brama-app/apps/admin)
Next.js fullstack:
- Supabase Auth (email + magic link → OAuth Google/GitHub у Phase 2)
- Tenant onboarding + integration connect flows (OAuth callbacks)
- API key management
- Billing UI (Stripe Payment Links → Stripe Billing Phase 2)
- Audit logs view