Connect an MCP client

Pragma ships a full MCP (Model Context Protocol) server: 81 tools covering the work graph — creating and querying items, typed links, workflows, kanban boards, and the analysis layer (critical path, impact analysis, bottleneck and orphan detection).

Endpoint

URL	https://api.pragma.pm/mcp
Transport	Streamable HTTP
Auth	OAuth 2.1 (dynamic client registration)

Claude Code

claude mcp add pragma --transport http https://api.pragma.pm/mcp

On first use, Claude Code opens a browser window: sign in to Pragma and approve the connection. No API key is pasted into any config file.

Any other MCP client

Any client that supports the Streamable HTTP transport and the MCP authorization spec works the same way:

1. The client fetches https://api.pragma.pm/.well-known/oauth-protected-resource (RFC 9728) and discovers the authorization server.
2. It registers itself automatically via dynamic client registration — no manual app-registration step.
3. It sends you to a browser consent page where you approve the connection.

Staying connected: offline_access

Access tokens are short-lived. The consent page offers an offline access checkbox (off by default): enable it and the client receives a refresh token, so it keeps working without asking you to re-authenticate.

Plans and metering

Connected AI apps are unlimited on every plan, including the free Starter plan, and agent activity is never metered — an agent making a thousand tool calls costs the same as one making none. See pricing for the full plan comparison.

Building your own client?

If you are integrating a tool that is not an off-the-shelf MCP client, read OAuth2 client registration for the raw OAuth endpoints and flows.