BTPR IntelligenceMCP documentation

Connect your PR workspace.

BlackTea PR Intelligence is a standalone, OAuth-protected MCP service. It stores durable PR context in its hosted control plane and uses pushed GitHub commits as source evidence.

Endpoint

https://mcp.blacktea.tech/api/mcp

The subdomain root also accepts MCP POST requests while keeping the public product page available on GET.

MCP clients discover OAuth through the protected-resource metadata endpoint. Authorization code flow with PKCE S256 is required. Dynamic client registration is supported.

Scopes

pr_read · pr_draft · pr_review · pr_approve
pr_outreach · pr_publish · pr_admin

An OAuth scope is only one gate. The service also checks workspace membership, server-side capability, classification, quota, exact artifact hash, and—where applicable—a fresh one-time action authorization.

Start a session

  1. Connect the MCP endpoint from Codex, ChatGPT, or another compatible client.
  2. Authorize the smallest scopes needed.
  3. Select a connected workspace, then invoke the continue-pr prompt or call resume_pr_workspace.
  4. For repository evidence, scan a pushed branch and fetch only the authorized source IDs needed for the story.

Safety boundary

Every generated artifact begins as a non-distributable draft. The agent cannot approve its own work. Material edits invalidate approvals. Sending and owned-channel publishing stay disabled unless all exact-content, integration, quota, destination, authorization, and idempotency checks pass. Paid press wires are never executed.