# Coassemble — how to use (mcp.ai)

Connect your Coassemble account and use 4 tools for online courses straight from your AI agent. Connect with your own API key. Coassemble is a platform that allows users to create, manage, and deliver online training courses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_coassemble?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `coassemble_get_clients`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/coassemble`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/coassemble/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/coassemble/get/clients` — Retrieve a paginated list of clients (organisations). Supports pagination via 'length' and 'page' parameters. Use when you need to list all client organisations or page through them systematically.
  - body: { page?: integer, length?: integer }
- `POST https://api.mcp.ai/api/coassemble/get/courses` — Retrieve all courses from your Coassemble account with optional filtering and pagination. Use this tool to list, search, or browse courses. You can filter by user identifier, client identifier, or tit
  - body: { page?: integer, title?: string, length?: integer, identifier?: string, clientIdentifier?: string }
- `POST https://api.mcp.ai/api/coassemble/get/trackings` — Retrieves learner progress tracking records for a specific course. Returns tracking objects containing progress percentages, completion status, and timestamps. Supports filtering by learner identifier
  - body: { id: integer, end?: string, page?: integer, start?: string, length?: integer, completed?: boolean, identifier?: string, clientIdentifier?: string }
- `POST https://api.mcp.ai/api/coassemble/get/users` — Tool to retrieve a paginated list of users. Use when you need to browse or process user records optionally filtered by clientIdentifier.
  - body: { page?: integer, length?: integer, clientIdentifier?: string }

## Example prompts
- "What can I do in Coassemble?"
- "Show me a summary of my Coassemble account"

## More
- Page: https://mcp.ai/coassemble
- Agent spec (llms.txt): https://mcp.ai/coassemble/llms.txt
- Postman collection: https://mcp.ai/coassemble/postman.json