Quickstart¶

Lawbster speaks the Model Context Protocol (MCP) over Streamable HTTP. Any client that understands MCP can add Lawbster as a tool source in two minutes.

Authentication — two paths¶

Method	Use it for	Token shape
API key	Server-to-server, scripts, custom apps, Cursor, Claude Desktop	`sk-legal-…`
OAuth 2.1	Browser clients (ChatGPT, Claude.ai), no plain-text token	JWT, automatic

API keys are created in the Lawbster portal under Keys. The plain-text key is shown only once — copy it straight into the client config.

MCP endpoint¶

https://lawbster.planitprima.com/mcp

Stateless Streamable HTTP — no session tracking, each request is fresh.

Per-client guides¶

Claude Desktop

The simplest path. JSON entry in the config file — done. Works on macOS, Windows, Linux.
:simple-openai:{ .lg .middle } ChatGPT & Claude.ai (web)

Browser-based OAuth flow, no plain-text token. Native connector support.
Cursor

.cursor/mcp.json in the project root. Lawbster tools available right in the Cursor Composer.
Copilot Studio

Custom connector with full tool and resource support — perfect for Microsoft stacks.

Custom app / SDK¶

For custom apps we recommend the official Python or TypeScript MCP SDKs. Endpoint, bearer token, Streamable HTTP — nothing else. Tool schemas are auto-discovered.

→ MCP Python SDK · MCP TypeScript SDK

Test without a client¶

curl -X POST https://lawbster.planitprima.com/mcp \
  -H "Authorization: Bearer sk-legal-..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Response contains all eight tools with JSON schema, ready to use.