BrAPI v2.1 MCP server — studies, germplasm, observations, genotypes, images, and pedigrees.
Connect Brapi to Claude, Cursor or any other MCP client and it stops being a tab you switch to. BrAPI v2.1 MCP server — studies, germplasm, observations, genotypes, images, and pedigrees. The brapi mcp server is what makes that connection.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
Multi — server session** — ServerRegistry maps aliases to live BrAPI connections; one session can span Breedbase, T3, and Sweetpotatobase in parallelBuilt — in known-server registry** — bti-cassava, bti-sweetpotato, bti-breedbase-demo, t3-wheat, t3-oat, t3-barley resolve out-of-the-box without env varsCapability — aware calls** — CapabilityRegistry caches /serverinfo per connection and guards every tool call against unsupported endpoints. Falls back to /callsAsync — search transparency** — brapi_find_genotype_calls and brapi_raw_search handle the POST /search/{noun} → GET /search/{noun}/{id} 202-retry patternFree — text variable ranking** — OntologyResolver scores variables against a query (PUI / name / synonym / trait-class) so find_variables text:"..." returnsbrapi_submit_observations — Two-phase observation write — mode: preview validates; mode: apply elicits confirmation, then fans POST + PUT in parallel. Additive only — noOrient — The Orient tool exposed by this serverRetrieve — The Retrieve tool exposed by this serverAnalyze — The Analyze tool exposed by this serverConfiguration is passed through the environment: MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, BRAPI_DEFAULT_BASE_URL, BRAPI_DEFAULT_OAUTH_CLIENT_ID, BRAPI_DEFAULT_API_KEY, CANVAS_EXPORT_PATH, BASE_URL, BRAPI_PROD_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Brapi's toolset — Multi, Built, Capability and 6 more — is a fair guide to whether it matches your workflow. It is maintained by cyanheads; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Brapi's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Multi | server session** — ServerRegistry maps aliases to live BrAPI connections; one session can span Breedbase, T3, and Sweetpotatobase in parallel. |
| Built | in known-server registry** — bti-cassava, bti-sweetpotato, bti-breedbase-demo, t3-wheat, t3-oat, t3-barley resolve out-of-the-box without env vars; orientation envelope carries CC-BY attribution. |
| Capability | aware calls** — CapabilityRegistry caches /serverinfo per connection and guards every tool call against unsupported endpoints. Falls back to /calls when /serverinfo is sparse. |
| Async | search transparency** — brapi_find_genotype_calls and brapi_raw_search handle the POST /search/{noun} → GET /search/{noun}/{id} 202-retry pattern automatically. |
| Free | text variable ranking** — OntologyResolver scores variables against a query (PUI / name / synonym / trait-class) so find_variables text:"..." returns ranked candidates even without /ontologies. |
| brapi_submit_observations | Two-phase observation write — mode: preview validates; mode: apply elicits confirmation, then fans POST + PUT in parallel. Additive only — no destructive deletion. |
| Orient | The Orient tool exposed by this server. |
| Retrieve | The Retrieve tool exposed by this server. |
| Analyze | The Analyze tool exposed by this server. |
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": ["-y", "@cyanheads/brapi-mcp-server"],
"env": {
"MCP_TRANSPORT_TYPE": "your-value",
"MCP_LOG_LEVEL": "your-value",
"BRAPI_DEFAULT_BASE_URL": "your-value",
"BRAPI_DEFAULT_OAUTH_CLIENT_ID": "your-value",
"BRAPI_DEFAULT_API_KEY": "your-value",
"CANVAS_EXPORT_PATH": "your-value",
"BASE_URL": "your-value",
"BRAPI_PROD_BASE_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| MCP_TRANSPORT_TYPE | Configuration value read at startup. | Optional |
| MCP_LOG_LEVEL | Configuration value read at startup. | Optional |
| BRAPI_DEFAULT_BASE_URL | Endpoint or connection string the server talks to. | Yes |
| BRAPI_DEFAULT_OAUTH_CLIENT_ID | Configuration value read at startup. | Optional |
| BRAPI_DEFAULT_API_KEY | Credential the server authenticates with. | Yes |
| CANVAS_EXPORT_PATH | Filesystem location the server is allowed to use. | Optional |
| BASE_URL | Endpoint or connection string the server talks to. | Yes |
| BRAPI_PROD_BASE_URL | Endpoint or connection string the server talks to. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.