Brapi MCP Server
@cyanheads/brapi-mcp-server A collaborative BrAPI v2.1 workspace for multi-agent research via MCP. Search studies, germplasm, genotypes, & more - across Breedbase, T3, Sweetpotatobase, & any BrAPI v2-compliant server. Its 25 documented tools cover brapi, dataframe, germplasm, observations. It runs locally over stdio via the published package.
People who work with brapi, dataframe and germplasm and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-09-13 · ★ 4 · #178 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18
Apache-2.0 · TypeScript servers · how we verify → /methodology
01 · Install Brapi MCP Server
before you install - you'll need
Set MCP_LOG_LEVEL, BRAPI_BTI_CASSAVA_USERNAME, BRAPI_BTI_CASSAVA_PASSWORD, BRAPI_PROD_BASE_URL, BRAPI_PROD_API_KEY, BRAPI_PROD_API_KEY_HEADER before connecting. MCP_TRANSPORT_TYPE is optional or environment-specific per the README.
Claude Code
claude mcp add cyanheads-brapi-mcp-server -- npx -y @cyanheads/brapi-mcp-server Claude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"cyanheads-brapi-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/brapi-mcp-server"
]
}
}
} Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license Apache-2.0 - declared in the repository
npm package @cyanheads/brapi-mcp-server - published under the repo owner's npm scope (@cyanheads)
registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner
03 · What Brapi MCP Server can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can list valid filter names for a BrAPI endpoint - companion lookup for extraFilters on any find_ tool, find studies by crop, trial type, season, location, or program, with distributions and dataframe spillover, fetch a study with program/trial/location resolved and companion counts (observations, units, variables), and find germplasm by name, synonym, accession, PUI, crop, or free text, with distributions and dataframe spillover.
The 25 tools it gives your agent
Extracted from the project's README - what brapi-mcp-server lets an agent do.
- brapi_connect
- - Authenticate to a BrAPI v2 server, register the connection under an alias, and return the full orientation envelope in one call.
- brapi_server_info
- - Re-fetch the orientation envelope for a registered alias, optionally forcing a capability refresh.
- brapi_describe_filters
- - List valid filter names for a BrAPI endpoint - companion lookup for extraFilters on any find_ tool.
- brapi_find_studies
- - Find studies by crop, trial type, season, location, or program, with distributions and dataframe spillover.
- brapi_get_study
- - Fetch a study with program/trial/location resolved and companion counts (observations, units, variables).
- brapi_find_germplasm
- - Find germplasm by name, synonym, accession, PUI, crop, or free text, with distributions and dataframe spillover.
- brapi_get_germplasm
- - Fetch a germplasm with attributes, direct parents, and companion counts (studies, parents, descendants).
- brapi_walk_pedigree
- - BFS-walk ancestry or descendancy as a deduplicated DAG with cycle detection and depth limits.
- brapi_find_variables
- - Find observation variables by name, trait class, ontology term, or free text, ranked via OntologyResolver.
- brapi_find_observations
- - Pull observation records by study, germplasm, variable, season, or unit, with dataframe spillover.
- brapi_find_images
- - Filter image metadata by unit, observation, study, ontology term, or MIME type. Bytes via brapi_get_image.
- brapi_get_image
- - Fetch image bytes for up to 5 imageDbIds inline as type: image content blocks.
show all 25 tools
- brapi_find_locations
- - Find research stations by country, type, abbreviation, or bounding box.
- brapi_find_variants
- - Find variant records by variant set, reference, or genomic region.
- brapi_find_genotype_calls
- - Pull genotype calls via async-search polling, bounded by an upstream pull ceiling.
- brapi_dataframe_describe
- - List dataframes (or describe one) with column schema, row counts, and originating-source provenance.
- brapi_dataframe_query
- - Run read-only SQL across in-memory dataframes (DuckDB-backed).
- brapi_dataframe_drop
- - _Opt-in._ Drop a dataframe by name. Idempotent.
- brapi_dataframe_export
- - _Opt-in, stdio-only._ Export a dataframe to disk as CSV, Parquet, or JSON.
- brapi_build_phenotype_matrix
- - Build a germplasm × trait matrix from one or more studies, materialized as a canvas dataframe.
- brapi_germplasm_performance
- - Per-variable performance aggregates (n, mean, median, sd, min, max) for a single germplasm across its studies.
- brapi_export_genotype_matrix
- - Export genotype calls for a variant set as a germplasm × variant matrix, plus VCF-lite / PLINK serialization.
- brapi_submit_observations
- - _Opt-in._ Two-phase observation write - preview validates, apply confirms and writes.
- brapi_raw_get
- - Passthrough to any BrAPI GET /{path} endpoint not covered by a curated tool.
- brapi_raw_search
- - Passthrough to any POST /search/{noun} endpoint, with async polling handled transparently.
Latest releases
v0.7.12 · 2026-09-13
Framework adoption and alias credential parsing · Empty and unsubstituted ${…} env values read as unset on BRAPI_<ALIAS>_ and BRAPI_, so a placeholder no longer registers a phantom alias or fails URL validation · A…
v0.7.11 · 2026-08-22
mcp-ts-core ^0.12.3 - MCP SDK v2 · Protocol revision 2026-07-28 served on every HTTP endpoint, alongside the 2025 era · Undeclared top-level tool arguments are rejected by name; advertised schemas are JSON Schema…
v0.7.10 · 2026-07-16
concurrent per-study observation pulls · brapi_germplasm_performance and brapi_build_phenotype_matrix now fan their per-study observation pulls out concurrently instead of one study at a time. · Changed…
04 · Who maintains Brapi MCP Server
brapi-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 119 actively maintained, 1,816 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.
- obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 681
- mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 151
- pubmed-mcp-server Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms. ★ 148
- git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
- clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 94
- ntfy-mcp-server Send, manage, and replay ntfy push notifications via MCP. ★ 22
05 · Facts
- repository
- github.com/cyanheads/brapi-mcp-server
- category
- other - ranked #178 of 945 actively-maintained other servers as of 2026-09-18.
- release cadence
- 7 releases in the last 90 days (latest 2026-09-13)
- registry
- io.github.cyanheads/brapi-mcp-server (active, first published 2026-04-30 · 43 versions)
- packages
- npm:@cyanheads/brapi-mcp-server · npm:@cyanheads/brapi-mcp-server
06 · Brapi MCP Server FAQ
Is Brapi MCP Server still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-13 and it shipped 7 releases in the last 90 days. We re-verify nightly.
What can Brapi MCP Server do?
With this server connected, an agent can list valid filter names for a BrAPI endpoint - companion lookup for extraFilters on any find_ tool, find studies by crop, trial type, season, location, or program, with distributions and dataframe spillover, fetch a study with program/trial/location resolved and companion counts (observations, units, variables), and find germplasm by name, synonym, accession, PUI, crop, or free text, with distributions and dataframe spillover.
How do I install Brapi MCP Server?
Run `npx -y @cyanheads/brapi-mcp-server`. The README documents 7 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, BRAPI_BTI_CASSAVA_USERNAME…) to set first. Set MCP_LOG_LEVEL, BRAPI_BTI_CASSAVA_USERNAME, BRAPI_BTI_CASSAVA_PASSWORD, BRAPI_PROD_BASE_URL, BRAPI_PROD_API_KEY, BRAPI_PROD_API_KEY_HEADER before connecting. MCP_TRANSPORT_TYPE is optional or environment-specific per the README. You can also paste the ready-made client config above.
Does Brapi MCP Server run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Brapi MCP Server
Alternatives to Brapi MCP Server
Maintained other servers if Brapi MCP Server isn't the fit.
- Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,552 · 2026-09-17
- Server Commands An MCP server to run arbitrary commands ★ 39,038 · 2026-09-11
- basebalance.cloud - x402 RPC & MCP gateway USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger. ★ 6,432 · 2026-08-26
- Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 5,069 · 2026-09-15
- Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,470 · 2026-09-18
- Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,681 · 2026-09-17
More MCP servers to compare · Census MCP Server · Clipboard MCP Server · Courtlistener MCP Server · Eur Lex MCP Server · Git MCP Server
More TypeScript MCP servers · Cdc Health MCP Server · Clinicaltrialsgov MCP Server · see all