Reference
Reference for the public REST API, the marboba CLI, the Terraform provider, and the @marboba/mcp MCP server.
The Reference section documents every programmatic surface MarBoba
exposes — all built on the same public /v1 API and the same
authentication.
| Surface | Coverage |
|---|---|
REST /v1 API | All endpoints, every parameter, every response shape |
CLI (marboba) | All subcommands + flags |
| Terraform provider | All resources + data sources |
MCP server (@marboba/mcp) | All read tools |
If you find a discrepancy between this reference and what a surface actually does, the deployed surface is authoritative — let us know at support@somexai.com and we’ll correct it.
Authentication
Every public surface authenticates with a Personal Access Token
(mb_pat_*). One token works across the REST API, the CLI, the
Terraform provider, and the MCP server.
Mint a PAT at apps.marboba.com → Settings → API Tokens. Tokens
inherit the scopes you grant — read is enough for catalog
browsing, write for mutations, admin for org-config changes.
Endpoint
The production API is at https://api.marboba.com.