Branch Docs

Installation

Use the hosted Branch MCP endpoint directly or connect it through a local bridge for desktop clients.

Claude Code

Install Claude Code and add the Branch MCP server:

npm install -g @anthropic-ai/claude-code
claude mcp add --transport http branch https://docs.branchapp.com/mcp
claude

Claude Desktop

Claude Desktop needs a local bridge to talk to the hosted server. Branch documents the following bridge configuration:

{
  "mcpServers": {
    "branch-payments": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://docs.branchapp.com/mcp"
      ]
    }
  }
}

Configuration

• Remote MCP endpoint: https://docs.branchapp.com/mcp
• Transport: Streamable HTTP
• Authentication: None required for the docs server itself

Prerequisites

• Claude Desktop, if using the desktop bridge workflow.
• Node.js v18 or higher, for local bridge setups and npx mcp-remote.
• Claude Code, if using the terminal workflow.
• Branch customer or partner access with a Branch API key for live API execution.
• Access to Branch sandbox or production credentials, depending on the environment.

Capabilities

• list-endpoints: lists API paths and methods.
• get-endpoint: returns endpoint details, parameters, request body, and response schemas.
• search-endpoints: searches paths, operations, and schemas.
• search: searches guide pages and returns titles and URLs.
• fetch: retrieves the full content of a guide page by ID.
• get-server-variables: returns server variables such as production and sandbox base URLs.
• execute-request: runs a live API call from a HAR request object.

Limitations

• execute-request requires a valid Branch API key passed in the apikey header.
• execute-request is available to Branch customers and partners.
• Sandbox accounts are for testing only; worker accounts are temporary and payouts are simulated.
• Sandbox KYC and fraud workflows are preset and do not run full production processing.
• Production testing requires real PII and unique worker identifiers.
• Some sandbox mobile application access is limited to certain partner organizations.