openfda-mcp-server — Claude Code MCP server, how to install
An MCP server that lets your agent query FDA records on drugs and devices through openFDA, including recalls and adverse events. Runs over STDIO or Streamable HTTP.
Apache-2.0 5,433 installs ★ 5 updated 2026-10-17
claude mcp add --transport http openfda-mcp-server https://openfda-mcp-server--cyanheads.run.toolsWhat openfda-mcp-server does
The server calls the public openFDA API and returns FDA records on drugs, food, medical devices and recalls. You can search adverse event reports and drug shortages, look at Drugs@FDA approvals (NDA and ANDA), check device clearances under 510(k) and PMA, and find a product by its NDC code.
For one drug name, openfda_drug_profile pulls the label, adverse events, recalls, approval and shortage in a single call. If a sub-query fails on the FDA side, that section is listed in degraded[], so treat it as unknown rather than empty. openfda_count_values tallies the values of any field, and openfda_describe_fields shows what an endpoint can be searched by.
Veterinary reports mask brand and manufacturer names as MSK, so search them by active ingredient. Date sorting depends on the category, and a field from a different category returns query_error. Search tools return up to 1000 records per page. The npx config passes OPENFDA_API_KEY.
What it helps with
- get a recall, approval and shortage summary from one drug name
- search adverse event reports for a drug, food or device
- check whether a medical device has a 510(k) or PMA clearance
- look up a drug by NDC code
- tally how often each value of a field appears in FDA data
Example prompts for the agent
- Use openfda-mcp-server to build an
openfda_drug_profilefor ibuprofen with label, adverse events and recalls. - Call
openfda_search_drug_shortagesand list drugs with statusCurrent. - Check
openfda_search_device_clearancesfor a 510(k) clearance on this device.
How to install openfda-mcp-server
Platform CLI: remote server
claude mcp add --transport http openfda-mcp-server https://openfda-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add openfda-mcp-server --url https://openfda-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"openfda-mcp-server": {
"url": "https://openfda-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"openfda-mcp-server": {
"type": "http",
"url": "https://openfda-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http openfda-mcp-server https://openfda-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about openfda-mcp-server
How do I install openfda-mcp-server in Claude Code?
Run claude mcp add --transport http openfda-mcp-server https://openfda-mcp-server--cyanheads.run.tools.
What does openfda-mcp-server do?
It connects your agent to the openFDA API. Through it you can search adverse events, recalls, drug approvals, device clearances and NDC codes, and read drug labels.
How do I search veterinary reports in openfda-mcp-server?
Brand and manufacturer names are masked as MSK there, so search by active ingredient, for example with drug.active_ingredients.name.