Reference

Supported clients

Lumin speaks the public Model Context Protocol over Streamable HTTP. Any compliant client works. These are the ones we test against.

Claude (web and desktop)

Add Lumin as a custom MCP connector. Paste https://mcp.lumin.guru/mcp for the open tier, or https://mcp.lumin.guru/mcp/auth with OAuth for the higher-limit tier.

Cursor

Add a server entry to .cursor/mcp.json pointing at the Lumin URL. Cursor handles the rest of the protocol natively.

Windsurf

Same shape as Cursor. Windsurf reads MCP server config and connects on session start.

Claude Code (CLI)

Run claude mcp add --transport http lumin-kp https://mcp.lumin.guru/mcp and you are connected. Useful for scripted readings or long horary sessions inside a terminal workflow.

Custom clients

Lumin uses Streamable HTTP transport with enableJsonResponse: true.
Standard MCP request shapes: tools/list, tools/call.
OAuth 2.1 endpoints exposed at /.well-known/oauth-authorization-server on the auth endpoint.
API key auth: Authorization: Bearer mcp_* header.

PreviousTiers and limits NextBilling and upgrades