# SMAO Developer Platform (https://docs.smao.ai/docs)



SMAO exposes an AI connector and two REST APIs. Pick your entry point:

<Cards>
  <Card title="MCP Connector" href="/docs/mcp" description="Connect ChatGPT, Claude, Cursor, and other MCP clients to read and configure a SMAO organization." />

  <Card title="Public API" href="/docs/public" description="Configure assistants, knowledge, contacts, calls and more - with your organization's API key." />

  <Card title="Distributor API v1" href="/docs/distributor-v1" description="Manage partners and customer organizations, assign plans, and read usage and billing." />
</Cards>

New here? Start with [Getting Started](/docs/getting-started), then
[Authentication](/docs/authentication) and [Errors & Rate Limits](/docs/errors).

## Trying requests [#trying-requests]

Every endpoint reference page includes an interactive playground. The raw
OpenAPI specifications are also available for your own tooling:

* Public API spec: [**SMAO\_API\_URL**/api/v1/openapi.yaml](https://api.smao.ai/api/v1/openapi.yaml) (tenant-branded per host)
* Distributor API v1 spec: [**SMAO\_API\_URL**/api/distributor-docs/v1/openapi.yaml](https://api.smao.ai/api/distributor-docs/v1/openapi.yaml)

The bare `/api/distributor-docs/openapi.yaml` path serves the same Distributor
v1 contract for integrations that saved that URL.