Guides

MCP

Overview

Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external tools and data sources. The Branch MCP server gives AI assistants structured, machine-readable access to the Branch Public API documentation — enabling them to browse endpoints, retrieve schemas, search guides, and execute API calls without manual copy-pasting from web pages.

Branch MCP Server Details

Server URLhttps://docs.branchapp.com/mcp
AuthenticationNone required
TransportStreamable HTTP

Available Tools

API Discovery

  • list-endpoints — Lists all API paths and HTTP methods, organized by path
  • get-endpoint — Returns full details for a specific endpoint, including parameters, request body, and response schemas
  • search-endpoints — Deep search across paths, operations, and component schemas by keyword

Documentation Search

  • search — Searches guide pages and returns matching results with titles and URLs
  • fetch — Retrieves the full content of a guide page by ID

Server Configuration

  • get-server-variables — Returns server variables from the OpenAPI spec (e.g. base URLs for production and sandbox)

API Execution

  • execute-request — Executes a live API call using a HAR request object. Requires a valid Branch API key passed as the apikey header. Available to Branch customers and partners.

Setup

Claude Code (Terminal)

Install Claude

npm install -g @anthropic-ai/claude-code

Install MCP

claude mcp add --transport http branch https://docs.branchapp.com/mcp

Start Claude

claude

At Claude prompt type:

What MCP tools are available?

Claude Desktop

Remote MCP servers require connection through Claude Desktop's Connectors settings. If your organization uses Claude Enterprise or Team, an admin must add the server as a custom connector:

Settings → Connectors → Add custom connector
Server URL: https://docs.branchapp.com/mcp

Once added, team members can enable it from the same menu.

Anthropic Directory (coming soon):
We've applied to have Branch listed in Anthropic's MCP connector directory. Once approved, you'll be able to connect with one click from Claude.ai, Claude Desktop, and Claude mobile.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "branch": {
      "url": "https://docs.branchapp.com/mcp"
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "branch": {
      "url": "https://docs.branchapp.com/mcp"
    }
  }
}

Example Prompts

  • "What endpoints does Branch have for managing worker disbursements?"
  • "How do I create a disbursement for a worker? Walk me through the process."
  • "Send a $25 tip to worker 123456 in org 100000, use external ID tip-2026-001"

Support & Legal

Updated 12 days ago