Built LMS Help Center
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/mcp

Token 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 scope values.

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: true with numbered field messages.
  • REST 4xx responses return isError: true.
  • REST 5xx, network failures, and timeouts return JSON-RPC -32000 protocol errors.

On this page