Branch Docs MCP server
Commit Nov 3, 2026Allows AI agents to dynamically query, search, and parse the live Branch API reference through a cloud-hosted MCP server.
Also known as branch-docs/ai, ai
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Nov 3, 2026
- License
- —
What is Branch Docs MCP?
Branch Docs allows AI agents to dynamically query, search, and parse the live Branch API reference through a cloud-hosted MCP server.
Summary generated from the project's README
About Branch Docs MCP server
Branch Docs provides a cloud-hosted MCP server designed to connect AI agents directly to the live Branch API reference. This managed service uses a streamable HTTP transport mechanism, which removes the need for local runtime dependencies, Node modules, or manual compilation. Developers can integrate this server into MCP-capable clients like Claude Desktop by adding the specific endpoint URL to their ecosystem configuration file.
Beyond the automated server, the repository offers specialized Claude Skills that function as structured behavioral guardrails. These skills are manually uploaded as zip files from a distribution directory into a Claude workspace. While the MCP server handles real-time documentation lookups, these skills provide architectural guidance for complex tasks like managing sensitive KYC data or optimizing global payout structures. This dual approach ensures that AI assistants can both find technical details and follow compliant engineering patterns.
What you can do with it
- 1Real-time API discoveryAsk an AI agent to search and parse the current Branch API documentation to find specific technical details.
- 2Secure onboarding implementationUse the onboarding expert skill to ensure worker payout flows follow secure patterns and avoid mishandling sensitive data.
- 3Automated integration auditingProvide code snippets to the integration audit skill to receive a compliance report on architectural vulnerabilities.
Written from the project's README. Every use case is checked against a quote from it.
How to install Branch Docs MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Branch Docs MCP in Claude Code
$ claude mcp add --transport http ai https://docs.branchapp.com/mcpInstall Branch Docs MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ai": {
"url": "https://docs.branchapp.com/mcp"
}
}
}Install Branch Docs MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ai": {
"type": "http",
"url": "https://docs.branchapp.com/mcp"
}
}
}Install Branch Docs MCP in VS Code CLI
$ code --add-mcp '{"name":"ai","type":"http","url":"https://docs.branchapp.com/mcp"}'Install Branch Docs MCP in Codex
$ codex mcp add ai --url https://docs.branchapp.com/mcpInstall Branch Docs MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ai] url = "https://docs.branchapp.com/mcp"
Install Branch Docs MCP in Gemini CLI
$ gemini mcp add -s user --transport http ai https://docs.branchapp.com/mcpInstall Branch Docs MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ai": {
"url": "https://docs.branchapp.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebranch-docs/ai is public and reachablegithub.com/branch-docs/ai ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-03github.com/branch-docs/ai ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 580 msPass
README
View on GitHubBranch AI & MCP Gateway
Welcome to Branch's centralized hub for public AI resources and integrations. This repository bridges the gap between AI assistants and the Branch platform by exposing two distinct integration vectors:
- Automated MCP Infrastructure: A live, cloud-hosted Model Context Protocol (MCP) server for real-time API reference discovery.
- Contextual Claude Skills: Specialized, pre-configured instruction sets that guide AI models through compliant engineering and onboarding patterns.
1. Automated Model Context Protocol (MCP) Server
Branch runs a managed cloud-native MCP server directly through our core documentation platform. This server securely exposes read-only tools allowing AI agents to dynamically query, search, and parse the live Branch API reference.
Because this is hosted via the cloud, there is no local environment configuration required—no local runtime dependencies, Node modules, scripts, or manual compilation.
- Endpoint Gateway URL: https://docs.branchapp.com/mcp
- Transport Mechanism: Streamable HTTP
Integration & Configuration
To expose Branch's documentation tools to an MCP-capable client (such as Claude Desktop), add the endpoint to your ecosystem configuration file.
For Claude Desktop, append the following block to your configuration schema (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows) and restart the application:
{
"mcpServers": {
"branch-docs": {
"type": "http",
"url": "https://docs.branchapp.com/mcp"
}
}
}
Once initialized, your AI assistant will programmatically discover, surface, and execute the server's documentation lookups autonomously during active conversations.
2. Enterprise Claude Skills (Manual Provisioning)
The /skills directory contains packaged Claude Skills. These are explicit, highly structured behavioral guardrails that train an AI model to architect Branch integrations safely and correctly (e.g., properly routing sensitive KYC data outside of partner applications, utilizing standard webhooks, and optimizing global payout architectures).
Important Deployment Note
Unlike the MCP Server, Claude Skills do not self-load. Due to the sandboxed, contextual design of LLM workspaces, an AI assistant cannot discover, activate, or persist these instructions simply by reading or crawling this repository. Connecting the MCP server does not import these skills; they operate on a separate infrastructure layer. They must be manually uploaded into your Claude workspace environment using the steps below.
Workspace Deployment (Individual Accounts)
- Navigate to the
/distdirectory in this repository and download the compiled.ziparchive for your desired skill. - In your Claude interface, open Customize ➔ Skills.
- Upload the downloaded
.zipfile to activate it within your account. Note: Ensure "Code Execution" is toggled on within your individual Claude workspace settings.
Enterprise Distribution (Organization-Wide)
To provision a skill globally across an entire enterprise workspace so individual users do not have to configure it manually:
- An Organization Owner must navigate to Organization Settings ➔ Skills.
- Upload the target
.ziparchive from the/distfolder. - The skill will automatically cascade down and activate for all registered team accounts under the corporate domain.
Repository Structure: /skills vs /dist
To maintain open-source transparency while providing seamless deployment, this repository separates source materials from production assets:
/skills(Source Framework): Contains editable, human-readable markdown manifests (SKILL.md) and contextual reference schemas. This is the development workspace where updates, code contributions, and peer reviews occur./dist(Production Builds): Contains the compiled, ready-to-upload.zipdeployment packages. Each archive bundles the corresponding markdown source and linked assets into a single-step upload package compatible with Claude's ingestion engine.
When source files in /skills are modified and merged, production artifacts in /dist are compiled automatically via automation workflows to maintain absolute parity.
Production-Ready Skills Matrix
-
branch-onboarding-expertEstablishes strict guardrails for handling Branch worker onboarding and payout flows. Strategically guides developer models away from high-risk or legacy endpoints that mishandle PII/KYC data, forcing alignment with Branch's secure hosted onboarding screens. -
branch-integration-auditAn autonomous code review engine. When fed active integration files or code snippets, it runs a structured compliance check, generating a definitive report highlighting structural vulnerabilities, integration warnings, and passing architectural patterns.
Core Client Compatibility
The skills provided in this hub are optimized for the SKILL.md syntax native to Anthropic's Claude ecosystem. While the underlying functional logic and compliance guidelines remain universally applicable across any generative AI framework, the explicit setup, ingestion, and execution instructions detailed above are tailored exclusively to Claude workspaces.
Branch Docs MCP questions
How do I add Branch Docs MCP to Claude Code?
Run claude mcp add --transport http ai https://docs.branchapp.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Branch Docs MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I integrate Branch Docs with Claude Desktop?
Append the branch-docs configuration block containing the HTTP endpoint URL to your Claude Desktop configuration JSON file and restart the application.
Do I need to install anything locally to use the MCP server?
No, the server is cloud-hosted, so there are no local runtime dependencies, Node modules, or manual compilation required.