MCP Server
MCP Quickstart
Authenticate a backend agent and call Built LMS MCP tools.
MCP Quickstart
Use the hosted MCP endpoint from a server-side agent process. Do not use human browser sessions or public client code for MCP credentials.
Endpoint
POST https://mcp.builtlms.com/mcp
Authorization: Bearer <oauth-access-token>OAuth protected resource metadata is published at:
GET https://mcp.builtlms.com/.well-known/oauth-protected-resource/mcpToken Requirements
- The token is issued by Better Auth OAuth client credentials.
- The token audience is
https://mcp.builtlms.com/mcp. - The token includes
organization_id. - The token includes space-delimited or array
scopevalues.
Discovery
tools/list only returns tools whose required scopes are present on the token and whose tenant/tool kill switches are not paused.
Writes
Every mutating tool requires idempotency_key. Reusing the same key with the same input returns the cached successful result for 24 hours. Reusing the same key with different input returns a tool error.
Errors
- Input validation returns
isError: truewith numbered field messages. - REST 4xx responses return
isError: true. - REST 5xx, network failures, and timeouts return JSON-RPC
-32000protocol errors.