Creator OS API Documentation

This document describes the public discovery surface for Creator OS and the primary API surfaces used by the product, MCP package, and AI agents.

Site: usecreator.app
Functions API: https://nokaflklgqogjltawxda.supabase.co/functions/v1
Auth issuer: https://nokaflklgqogjltawxda.supabase.co/auth/v1

Discovery Endpoints

/.well-known/api-catalog for RFC 9727 API discovery.
/.well-known/openid-configuration and /.well-known/oauth-authorization-server for OAuth/OIDC discovery.
/.well-known/oauth-protected-resource for OAuth protected resource metadata.
/.well-known/agent-card.json for A2A agent discovery.
/.well-known/mcp/server-card.json for MCP server discovery.
/.well-known/agent-skills/index.json for agent skill discovery.
/.well-known/acp.json for commerce capability discovery.

OpenAPI

The machine-readable API description is published at /openapi.json.

Authentication

Creator OS uses Supabase Auth for browser and API sessions. Discovery metadata published on this domain points agents to the actual Supabase issuer and JWKS endpoints. Protected function routes expect bearer tokens. MCP routes additionally support Creator OS MCP tokens prefixed with mcp_.

The protected resource metadata at /.well-known/oauth-protected-resource is authoritative for https://usecreator.app, matching the resource identifier published on this domain per RFC 9728.

A2A Agent Card

Creator OS publishes a public Agent Card at /.well-known/agent-card.json. The declared HTTP+JSON interface URL is https://usecreator.app/a2a.

The public card focuses on discovery metadata, authentication guidance, and MCP connectivity so other agents can understand how to reach Creator OS capabilities.

Primary API Capabilities

Public showcase

GET /public-showcase returns public creator showcase items.

Billing and checkout

POST /create-checkout creates a subscription checkout session for the authenticated user.

POST /check-subscription returns the caller's current subscription state.

MCP

POST https://usecreator.app/mcp exposes the hosted Streamable HTTP MCP endpoint.

POST /mcp-token-manage, POST /mcp-usage, POST /external-mcp-manage, and POST /mcp-auth-exchange support Creator OS MCP access and external MCP connections.

Remote MCP discovery is published at /.well-known/mcp/server-card.json.

Commerce

Creator OS currently exposes authenticated checkout initiation through its existing subscription APIs. The discovery document at /.well-known/acp.json advertises the commerce surface that agents can reason about today.

Markdown for Agents

A markdown version of the homepage is available at /index.md. If the site is deployed behind a compatible proxy such as Cloudflare's Markdown for Agents feature, the root document can additionally negotiate Accept: text/markdown.

Status

A public status document for discovery clients is published at /.well-known/status.json.

Example

curl https://usecreator.app/.well-known/api-catalog
curl https://usecreator.app/openapi.json
curl https://usecreator.app/.well-known/openid-configuration
curl https://usecreator.app/.well-known/agent-card.json
curl https://usecreator.app/.well-known/mcp/server-card.json