# Branch Docs

> Access and search Branch's official API documentation directly within any AI agent or client.

- name: io.github.branch-docs/ai
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 70/100 flags: no-repository
- quality: 84/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.branch-docs%2Fai
- tools: https://api.protogrid.dev/v1/servers/io.github.branch-docs%2Fai/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "ai": {
      "type": "sse",
      "url": "https://docs.branchapp.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 65
- provenance: 35
- drivers: +reachable +uptime-100% ~updated-121d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 84/100 (good)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- warn `protocol.transport`: only the legacy HTTP+SSE transport, deprecated until 2027-07-28
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 60000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list-endpoints (idempotentHint); list-webhook-events (idempotentHint); branch-overview (idempotentHint); …
- pass `tools.token_cost`: about 875 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 8 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 875 tokens to load them all
- tool set hash: dc62a2be598daede024b086036d97ca8
- tools last changed: 2026-09-24T04:06:37.862Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.branch-docs/ai.svg)](https://protogrid.dev/servers/io.github.branch-docs/ai)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-24 `branch-overview` changed (annotations)
- 2026-09-24 `list-webhook-events` changed (annotations)
- 2026-09-24 `fetch` changed (annotations)
- 2026-09-24 `search` changed (annotations)
- 2026-09-24 `get-server-variables` changed (annotations)
- 2026-09-24 `search-endpoints` changed (annotations)
- 2026-09-24 `get-endpoint` changed (annotations)
- 2026-09-24 `list-endpoints` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/io.github.branch-docs%2Fai/changes

## Remotes

- https://docs.branchapp.com/mcp (sse, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (8)

- `branch-overview`: Call this when the user is new to Branch or is asking what Branch is, what it does, how its core objects relate (organizations, workers, wallets, payment profiles, disbursements), or where to begin an integration. Returns a one-page orientation: the object model, the worker lifecycle from onboarding through payment, the two integration approaches, and the sandbox and production environments. For specific procedures or API details, use search, fetch, and get-endpoint instead — this tool is orientation only.
- `fetch`: Gets detailed content for documentation by ID returned from the `search` tool.
- `get-endpoint`: Gets detailed information about a specific API endpoint, including security schemes and servers
- `get-server-variables`: Gets the server variables for each server within a specific OpenAPI spec.
- `list-endpoints`: Lists all API paths and their HTTP methods with summaries, organized by path. Results can be passed directly into 'get-endpoint'.
- `list-webhook-events`: Call this when the user asks about Branch webhooks, events, notifications, or callbacks — including which events exist, what data an event contains, or which event fires at a given point in worker onboarding or payment. Returns the complete catalog of all 22 Branch webhook events with their payload fields. Use the fetch tool with a listed doc id to get full details and a JSON example for a specific event.
- `search`: Searches through documentation with the given search query, returning a list of results with ID, title, and URL.
- `search-endpoints`: Performs a deep search through paths, operations, and parameters to discover relevant API endpoints. Use this tool to find specific API capabilities, required parameters, or data models based on search keywords. Results can be passed directly into 'get-endpoint'.
