Skip to Content
V1MCP ServerTransports

Transports

The Lore MCP Server supports two transport modes.

stdio (Local)

The stdio transport is used when the AI harness spawns the MCP Server as a subprocess. Best for local developer setups.

Not yet distributed. lore-mcp has no public binary download today — this section documents the transport for reference; it isn’t a supported install path yet. Until it is, connect via the hosted http transport instead (see MCP Server Setup).

Configuration (Claude Code ~/.claude/settings.json):

{ "mcpServers": { "lore": { "command": "lore-mcp", "args": ["--transport", "stdio"], "env": { "LORE_AUTH_TOKEN": "<token>", "LORE_REGISTRY_URL": "https://registry.lore.infraestrutura.app" } } } }

Startup:

lore-mcp --transport stdio

Streamable HTTP (Hosted)

The http transport implements the MCP spec’s Streamable HTTP transport (spec revision 2025-03-26 and later) — a single endpoint used for the hosted MCP Server at mcp.lore.infraestrutura.app. This supersedes the older, deprecated “HTTP+SSE” transport.

Authentication is OAuth 2.1 (Dex as the authorization server, lore-mcp as a pre-registered public client), not a static bearer header — see MCP Server Setup for the actual connector/claude mcp add walkthrough per client. Public packages work with no token at all; the client only needs to complete OAuth for private-namespace access.

Self-hosted deployment:

lore-mcp --transport http --port 8080

Self-hosting over http additionally requires LORE_MCP_PUBLIC_URL and LORE_MCP_AUTH_ISSUER (see below) — lore-mcp refuses to start over HTTP without both, since they’re what it advertises in its /.well-known/oauth-protected-resource discovery document.

Environment Variables

VariableDescriptionDefault
LORE_AUTH_TOKENStatic bearer token for registry auth — used by stdio (no per-request caller identity to scope to); ignored by http, which forwards each caller’s own OAuth token instead—
LORE_REGISTRY_URLRegistry base URLhttps://registry.lore.infraestrutura.app
LORE_TARGETDefault render target (claude, cursor, copilot, codex, gemini, raw)Auto-detected from the client, falling back to raw
LORE_DEFAULT_LANGDefault content language (BCP 47)en-US
LORE_ORGDefault org scope for namespace resolution—
LORE_CACHE_TTLContent cache TTL, in seconds300
LORE_MCP_PUBLIC_URLThis server’s own public URL — http transport only—
LORE_MCP_AUTH_ISSUERThe OIDC issuer (Dex) callers authenticate against — http transport only—
© 2025 Lore · Built by M1 Cloud