brapi-guide

brapi-guide is a skill for Claude Code from cyanheads/brapi-mcp-server. It costs 43 tokens per session (1,094 once invoked), scanned A, original, Apache-2.0.

A guide for using BrAPI tools to study plant-breeding data. BrAPI is a standard interface for finding trials, traits, plant samples, observations, and genetic variant results across research systems.

In plain words
What is it for?
Use it to compare traits across studies, check whether trials measured a trait, retrieve genotype calls, export variants, and query staged results in SQL.
Why use it?
It helps avoid comparing records with mismatched identifiers or definitions, and prevents treating an unchecked empty search as proof that data is absent.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the brapi-mcp-server plugin — 35 skills, 1 MCP server shipped together

Good fit Use it to compare traits across studies, check whether trials measured a trait, retrieve genotype calls, export variants, and query staged results in SQL.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cyanheads/brapi-mcp-server/brapi-guide
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add cyanheads/brapi-mcp-server --skill brapi-guide
Clone the repo
git clone --depth 1 https://github.com/cyanheads/brapi-mcp-server

Made for: Claude Code.

Or install brapi-mcp-server, the plugin that ships this one along with the rest of its 35 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for brapi-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/cyanheads/brapi-mcp-server/brapi-guide/github.svg)](https://agentmods.dev/skills/cyanheads/brapi-mcp-server/brapi-guide)
Your own site
<a href="https://agentmods.dev/skills/cyanheads/brapi-mcp-server/brapi-guide"><img src="https://agentmods.dev/badge/skills/cyanheads/brapi-mcp-server/brapi-guide/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for brapi-guide

Your own site · 80×15
<a href="https://agentmods.dev/skills/cyanheads/brapi-mcp-server/brapi-guide"><img src="https://agentmods.dev/badge/skills/cyanheads/brapi-mcp-server/brapi-guide.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,094 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.01094
Opus 5.5 $0.00017 $0.00438
Sonnet 5.5 $0.00009 $0.00219
Haiku 4.5 $0.00004 $0.00109

Measured 5d ago against content hash 830ef943047b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

brapi-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/brapi-guide/SKILL.md · 62 lines

How it starts

The opening of the file, as written. The whole thing — 62 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Scope

Work within a BrAPI upstream's advertised endpoints. Access depends on the upstream, which may require credentials configured by the operator.

Identifiers

Keep every BrAPI ID with the upstream connection that produced it. If comparing across connections, verify the biological identity and measurement definitions before joining records.

ID Where to get it
germplasmDbId brapi_find_germplasm rows after resolving a name or accession.
observationVariableDbId brapi_find_variables rows or ranked ontologyCandidates that carry a variable ID. Use a trait label or ontology PUI to find candidates.
studyDbId brapi_find_studies for candidate studies, matching brapi_find_observations rows or contributing brapi_germplasm_performance studies for evidence of measurement.
variantSetDbId Rows from brapi_raw_get on /variantsets. Follow upstream pages when searching for a set.
variantDbId, callSetDbId Variant IDs from brapi_find_variants or genotype-call rows. Call-set IDs come from genotype-call rows.

Gates

  • Before concluding that a study or measurement is absent, check the scan and its filters. A limited discovery, ignored filter, failed study, or incomplete scan leaves coverage unresolved. Treat a completed empty result as evidence only within the scope actually checked.
  • Before pooling values, compare the variables' scales, units, and methods. Convert compatible units explicitly and keep incompatible measurements separate.
  • Check the available tools before planning file export, cleanup, or observation submission. Dataframe file export requires a configured stdio server, while drop and observation submission are opt-in. Preview observations first and get the user's confirmation before applying the write.

Workflows

Compare phenotypes across studies

On SGN/Breedbase, scope brapi_find_observations to a study or germplasm to use embedded observations when the upstream advertises that route. If an observation search skips collection, get contributing study IDs from brapi_germplasm_performance, then retry against those studies or other known study IDs. A germplasm filter on study discovery can be ignored upstream. Verify study membership from matching observations, and use brapi_get_study for trial, location, and season context.

Read the full file on GitHub · 62 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 62 lines · 43 tokens per session scan A 830ef943047b

Subscribe to this mod's changes

brapi-guide is a skill published in the GitHub repository cyanheads/brapi-mcp-server (4 stars, last pushed 4d ago), licensed Apache-2.0. It adds 43 tokens to every session and 1,094 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-12.

Related

brapi-guide compared with skills from other repositories

brapi-guide next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
brapi-guidecyanheads/brapi-mcp-serverSkill44d agoApache-2.0A43Claude Code
pubchem-guidecyanheads/pubchem-mcp-serverSkill134d agoApache-2.0A87Claude Code
molview-specPDBeurope/PDBe-MCP-ServersSkill442d agoApache-2.0A57Claude Code, Codex
calculator-guidecyanheads/calculator-mcp-serverSkill35d agoApache-2.0A83Claude Code
protein-guidecyanheads/protein-mcp-serverSkill63d agoApache-2.0A95Claude Code
axiom-mathtufantunc/axiom-advanced-math-mcpSkill3yesterdayGPL-3.0A74Claude Code, Codex
noodle-biomedical-literature-discoveryhelena-bioinformatics/noodle-mcpSkill02mo agoApache-2.0A105Codex