{"name":"io.github.cyanheads/openfda-mcp-server","slug":"cyanheads-openfda-mcp-server","title":null,"description":"Query FDA data on drugs, food, devices, and recalls via openFDA. STDIO or Streamable HTTP.","url":"https://mcp.market/server/cyanheads-openfda-mcp-server","rating":null,"grade":"A","score":86,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":41,"stars":4,"forks":2,"downloads_week":708,"last_push_at":"2026-09-16T10:59:49.000Z","license":"Apache-2.0"},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/cyanheads/openfda-mcp-server","website":null,"version":"0.7.5","remotes":[{"type":"streamable-http","url":"https://openfda.caseyjhand.com/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/openfda-mcp-server","version":"0.7.5","runtimeHint":"bun","transport":{"type":"stdio"},"environmentVariables":[{"description":"Free API key from open.fda.gov — increases daily limit from 1K to 120K requests.","format":"string","name":"OPENFDA_API_KEY"},{"description":"Serve exact-key lookups for drug/label, drug/ndc, drug/enforcement, and drug/drugsfda from a local bulk mirror instead of the API. Off by default; the initial harvest runs out-of-band via the mirror:init script.","format":"string","default":"false","name":"OPENFDA_MIRROR_ENABLED"},{"description":"Directory holding one SQLite file per mirrored dataset.","format":"string","default":"./data/openfda-mirror","name":"OPENFDA_MIRROR_PATH"},{"description":"Cron expression for the in-process mirror refresh. HTTP transport only; stdio operators run mirror:refresh from the host. Requires the optional node-cron peer dependency.","format":"string","name":"OPENFDA_MIRROR_REFRESH_CRON"},{"description":"Fall back to the live API when the mirror is cold, missing the record, or failing. Disable to fail loudly instead.","format":"string","default":"true","name":"OPENFDA_MIRROR_FALLBACK_LIVE"},{"description":"Wall-clock budget for one scheduled refresh before it is aborted. Raise it for drug/label, the only multi-partition dataset.","format":"string","default":"21600000","name":"OPENFDA_MIRROR_REFRESH_TIMEOUT_MS"},{"description":"Host serving the openFDA bulk download manifest. Override only to harvest from a private mirror of the dumps.","format":"string","default":"https://api.fda.gov","name":"OPENFDA_MIRROR_BASE_URL"},{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]},{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/openfda-mcp-server","version":"0.7.5","runtimeHint":"bun","transport":{"type":"streamable-http","url":"http://localhost:3010/mcp"},"environmentVariables":[{"description":"Free API key from open.fda.gov — increases daily limit from 1K to 120K requests.","format":"string","name":"OPENFDA_API_KEY"},{"description":"Must be set to 'http' for streamable HTTP transport.","isRequired":true,"format":"string","default":"http","name":"MCP_TRANSPORT_TYPE"},{"description":"The hostname for the HTTP server.","format":"string","default":"127.0.0.1","name":"MCP_HTTP_HOST"},{"description":"The port to run the HTTP server on.","format":"string","default":"3010","name":"MCP_HTTP_PORT"},{"description":"The endpoint path for the MCP server.","format":"string","default":"/mcp","name":"MCP_HTTP_ENDPOINT_PATH"},{"description":"Authentication mode to use: 'none', 'jwt', or 'oauth'.","format":"string","default":"none","name":"MCP_AUTH_MODE"},{"description":"Serve exact-key lookups for drug/label, drug/ndc, drug/enforcement, and drug/drugsfda from a local bulk mirror instead of the API. Off by default; the initial harvest runs out-of-band via the mirror:init script.","format":"string","default":"false","name":"OPENFDA_MIRROR_ENABLED"},{"description":"Directory holding one SQLite file per mirrored dataset.","format":"string","default":"./data/openfda-mirror","name":"OPENFDA_MIRROR_PATH"},{"description":"Cron expression for the in-process mirror refresh. HTTP transport only; stdio operators run mirror:refresh from the host. Requires the optional node-cron peer dependency.","format":"string","name":"OPENFDA_MIRROR_REFRESH_CRON"},{"description":"Fall back to the live API when the mirror is cold, missing the record, or failing. Disable to fail loudly instead.","format":"string","default":"true","name":"OPENFDA_MIRROR_FALLBACK_LIVE"},{"description":"Wall-clock budget for one scheduled refresh before it is aborted. Raise it for drug/label, the only multi-partition dataset.","format":"string","default":"21600000","name":"OPENFDA_MIRROR_REFRESH_TIMEOUT_MS"},{"description":"Host serving the openFDA bulk download manifest. Override only to harvest from a private mirror of the dumps.","format":"string","default":"https://api.fda.gov","name":"OPENFDA_MIRROR_BASE_URL"},{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]}],"tools":[{"name":"openfda_count_values","description":"Aggregate and tally unique values for any field across any openFDA endpoint. Returns ranked term-count pairs sorted by count descending. Pair with openfda_search_adverse_events, openfda_search_drug_approvals, openfda_search_device_clearances, openfda_search_recalls, openfda_get_drug_label, or openfda_lookup_ndc when sample records help interpret the aggregates.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"endpoint":{"type":"string","enum":["drug/event","drug/label","drug/enforcement","drug/ndc","drug/drugsfda","drug/shortages","food/event","food/enforcement","device/event","device/510k","device/pma","device/recall","device/enforcement","device/classification","device/registrationlisting","device/udi","device/covid19serology","animalandveterinary/event","tobacco/problem","other/substance"],"description":"Full openFDA endpoint path (e.g. \"drug/event\", \"device/classification\")"},"count":{"type":"string","minLength":1,"pattern":"\\S","description":"Field to count. Append .exact for whole-phrase counting of free-text fields (e.g. \"patient.reaction.reactionmeddrapt.exact\"). Identifier fields openFDA already indexes as keywords (product_ndc, application_number, pma_number) must be counted bare — .exact on those is rejected as not countable."},"search":{"description":"Filter query to scope the count (e.g. patient.drug.medicinalproduct:\"metformin\"). Omit to count across every record in the endpoint. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"limit":{"default":100,"description":"Number of top terms to return (default 100, max 1000)","type":"number","minimum":1,"maximum":1000}},"required":["endpoint","count"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_dataframe_describe","description":"List the tables and column schemas on a DataCanvas staged by an openFDA search tool. Call before openfda_dataframe_query to discover the exact table name, column names, and DuckDB types needed for valid SQL. row_count is the full staged result set, not the inline preview count. Columns typed JSON hold nested openFDA objects/arrays — query them with DuckDB json functions.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"canvas_id":{"type":"string","minLength":1,"pattern":"\\S","description":"Canvas ID from an openFDA search tool response (present when the search ran with stage=true)."}},"required":["canvas_id"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_dataframe_query","description":"Run a read-only SQL SELECT against a DataCanvas table staged by an openFDA search tool (call one with stage=true; its response carries canvas_id + canvas_table). Enables GROUP BY, COUNT/SUM/AVG, time-series, and joins across the staged result set without re-paging the API. Call openfda_dataframe_describe first to get the exact table and column names. Results are capped at the canvas row limit — when truncated is true, page the rest with ORDER BY plus LIMIT/OFFSET. Scalar fields are stored as text (CAST for numeric math); nested objects/arrays are JSON columns — read them with DuckDB json functions, e.g. json_extract_string(openfda, '$.brand_name[0]'). Only SELECT is allowed — DDL, DML, COPY, and file-reading functions are blocked.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"canvas_id":{"type":"string","minLength":1,"pattern":"\\S","description":"Canvas ID from an openFDA search tool response (the canvas_id field, present when the search ran with stage=true)."},"query":{"type":"string","minLength":1,"pattern":"\\S","description":"SQL SELECT against the staged table. Use the table name from openfda_dataframe_describe. Example: \"SELECT classification, COUNT(*) AS n FROM spilled_ab12cd34 GROUP BY classification ORDER BY n DESC\"."}},"required":["canvas_id","query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_describe_fields","description":"Return the searchable field paths for an openFDA endpoint, grouped by category with type and description. Use before constructing a search query to find the correct dotted field path — field names differ per endpoint and are not discoverable from the tool schema alone.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"endpoint":{"type":"string","enum":["drug/event","drug/label","drug/enforcement","drug/ndc","drug/drugsfda","drug/shortages","food/event","food/enforcement","device/event","device/510k","device/pma","device/recall","device/enforcement","device/classification","device/registrationlisting","device/udi","device/covid19serology","animalandveterinary/event","tobacco/problem","other/substance"],"description":"openFDA endpoint to describe (e.g. \"drug/event\", \"drug/shortages\", \"device/510k\"). Must be one of the cataloged endpoints."}},"required":["endpoint"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_drug_profile","description":"Resolve one drug name to its FDA identity, then fan out in parallel across the bounded per-drug openFDA endpoints and merge into one profile: identity, label highlights, adverse-event summary, recall history, Drugs@FDA approval, and shortage status. Replaces chaining openfda_get_drug_label, openfda_search_adverse_events, openfda_search_recalls, openfda_search_drug_approvals, and openfda_search_drug_shortages — and reconciles the identifier drift between endpoints that makes that chaining error-prone. Each section is best-effort: a miss returns null rather than failing the call. For deep dives into any one area, use the dedicated tool.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"drug":{"type":"string","minLength":1,"pattern":"\\S","description":"Drug name to profile — brand or generic (e.g. \"metformin\", \"Humira\", \"Glucophage\"). Resolved once to canonical FDA identifiers, which then key every sub-query."}},"required":["drug"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_get_drug_label","description":"Look up FDA drug labeling (package inserts / SPL documents). Check indications, warnings, dosage, contraindications, active ingredients, or any structured label section. A label runs to tens of thousands of tokens, so a page that exceeds the inline budget returns the list of available sections instead; re-call with sections to pull the ones you need.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"type":"string","minLength":1,"pattern":"\\S","description":"Query targeting label fields. Examples: openfda.brand_name:\"aspirin\", openfda.generic_name:\"metformin\", openfda.manufacturer_name:\"pfizer\". For a specific revision, pass set_id with the SPL UUID returned in earlier results. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request."},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: effective_time:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":5,"description":"Maximum number of results to return (1-1000). Default 5. Labels are large, and the cost of a sections selection is the section summed across every record on the page — so it scales with this limit. Lower it before widening a selection.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"sections":{"description":"Label sections to return, e.g. [\"boxed_warning\",\"indications_and_usage\"]. Names come from the outline an oversized page returns, or from openfda_describe_fields. Omit for the whole label — which returns the section outline instead when the page exceeds the inline size budget. A selection is returned whole even when it exceeds that budget, with its serialized size reported on the notice; the outline names a section measured to fit at the requested limit. Metadata (openfda, set_id, id, effective_time, version) is returned either way and counts toward the size.","type":"array","items":{"type":"string","minLength":1,"pattern":"\\S","description":"A top-level label section name."}}},"required":["search"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_lookup_ndc","description":"Look up drugs in the NDC (National Drug Code) Directory. Identify drug products by NDC code, find active ingredients, packaging details, or manufacturer info. Pair with openfda_get_drug_label using the returned brand_name or set_id to read the package insert.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"type":"string","minLength":1,"pattern":"\\S","description":"openFDA search query. Examples: product_ndc:\"0363-0218\", brand_name:\"aspirin\", generic_name:\"metformin\", openfda.manufacturer_name:\"walgreen\", active_ingredients.name:\"ASPIRIN\". Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request."},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: listing_expiration_date:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures. A record grows with its packaging list, so a product with many package configurations is several times the size of one with a single package.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this lookup onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"required":["search"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_adverse_events","description":"Search adverse event reports across drugs, food, and devices. Use to investigate safety signals, find reports for a specific product, or explore reactions by demographics.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"category":{"type":"string","enum":["drug","food","device"],"description":"Product category — each has different field schemas in the response"},"search":{"description":"openFDA search query. Examples: patient.drug.medicinalproduct:\"aspirin\", patient.reaction.reactionmeddrapt:\"nausea\" AND serious:\"1\". Omit to browse recent. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. Sortable date fields are category-specific: drug → receivedate:desc (or receiptdate), food → date_created:desc (or date_started), device → date_received:desc (or date_of_event). A field from another category (e.g. receivedate on food or device) causes a query error — use the field for this category.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures. Drug reports are by far the largest — a single drug/event report averages tens of kilobytes where a food/event report is a few hundred bytes.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"required":["category"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_animal_events","description":"Search adverse event reports for veterinary drugs and devices submitted to the FDA Center for Veterinary Medicine. Records include animal species, breed, age, weight, drug name and route, adverse reactions (using VeDDRA terminology), and outcome. Use to investigate safety signals for veterinary products, find reports by animal species or drug, or explore reaction patterns.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"description":"openFDA search query using field:value syntax. Examples: animal.species:\"Dog\", drug.brand_name:\"Bravecto\", reaction.veddra_term_name:\"Vomiting\", serious_ae:\"true\". Omit to browse recent reports. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: original_receive_date:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_device_clearances","description":"Search FDA device premarket notifications — 510(k) clearances and PMA approvals.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"pathway":{"type":"string","enum":["510k","pma"],"description":"Premarket pathway. 510(k) is the most common; PMA is for higher-risk devices."},"search":{"description":"openFDA search query. Examples: applicant:\"medtronic\", advisory_committee_description:\"cardiovascular\", product_code:\"DXN\", openfda.device_name:\"catheter\". Omit to browse recent. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: decision_date:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures. A 510(k) record carries a summary narrative and is several times the size of a PMA record.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"required":["pathway"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_drug_approvals","description":"Search the Drugs@FDA database for drug application approvals (NDAs and ANDAs). Returns application details, sponsor info, and full submission history. Pair with openfda_get_drug_label to read the approved label, or openfda_count_values to aggregate by sponsor_name, product_type, or route.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"description":"openFDA search query. Examples: openfda.brand_name:\"humira\", sponsor_name:\"PFIZER\", submissions.submission_type:\"ORIG\" AND submissions.review_priority:\"PRIORITY\". Exact quoted values can be case-sensitive on some fields — sponsor_name is stored uppercase, so use sponsor_name:\"PFIZER\" (a lowercase quoted value returns no matches). Omit to browse recent. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: submissions.submission_status_date:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures. A record carries its application's whole submission history, so a long-running application is an order of magnitude larger than a recent one.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_drug_shortages","description":"Search FDA drug shortage records. Returns per-product shortage status, availability, therapeutic category, dosage form, manufacturer, and dates. Use to check whether a drug is currently in shortage, find all oncology drugs with supply issues, or retrieve the openfda block (brand_name, product_ndc, rxcui) to chain into openfda_get_drug_label or openfda_lookup_ndc.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"description":"openFDA search query using field:value syntax. Examples: status:\"Current\", therapeutic_category:\"Oncology\", generic_name:\"carboplatin\", company_name:\"pfizer\". Omit to browse all records. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request. Call openfda_describe_fields({ endpoint: \"drug/shortages\" }) for the complete field list.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: update_date:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_recalls","description":"Search enforcement reports and recall actions across drugs, food, and devices.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"category":{"type":"string","enum":["drug","food","device"],"description":"Product category"},"endpoint":{"default":"enforcement","description":"Report type. Default enforcement. The recall endpoint is only available for devices.","type":"string","enum":["enforcement","recall"]},"search":{"description":"openFDA search query. Examples: classification:\"Class I\" (also \"Class II\" or \"Class III\"), recalling_firm:\"pfizer\", reason_for_recall:\"undeclared allergen\". Omit to browse recent. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort (e.g. report_date:desc,status.exact:asc). Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures. Device records are the largest here — a device enforcement or recall record runs several kilobytes where a drug or food enforcement record is around one.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"required":["category"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openfda_search_tobacco_reports","description":"Search problem reports submitted to the FDA for tobacco products, including e-cigarettes, vaping products, cigarettes, and smokeless tobacco. Reports capture product type, reported health problems (e.g. seizure, chest pain), product problems (e.g. exploding battery), whether a non-user was affected, and submission date. Use to investigate safety signals, find reports by product type, or analyze health effects.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"search":{"description":"openFDA search query using field:value syntax. Examples: tobacco_products:\"Electronic cigarette\", reported_health_problems:\"Seizure\", nonuser_affected:\"Yes\". Omit to browse recent reports. Double quotes, parentheses, and range brackets must balance, and the query must not end on a backslash — each is rejected before the request.","type":"string","minLength":1,"pattern":"\\S"},"sort":{"description":"Sort expression — a field path optionally suffixed with :asc or :desc; comma-separate for multi-field sort. Example: date_submitted:desc. Field paths take only letters, digits, underscores, and dots; anything else is rejected before the request. A well-formed but non-sortable field still causes a query error — use a documented field name.","type":"string","minLength":1,"pattern":"^ *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?(?: *, *[A-Za-z0-9_]+(?:\\.[A-Za-z0-9_]+)*(?::[^,:]*)?)* *$"},"limit":{"default":10,"description":"Maximum number of records to return (1-1000, default 10). Serialized record size varies by three orders of magnitude across openFDA endpoints, so the page is also bounded by a 24000-byte serialized budget: a page that would overrun it returns fewer records than requested and reports the cut on page_omitted. Whenever any record matched, at least one comes back, however large it measures.","type":"number","minimum":1,"maximum":1000},"skip":{"default":0,"type":"number","minimum":0,"description":"Number of records to skip for pagination (default 0). openFDA caps pagination at 25000 records; a higher value returns a pagination_limit_reached error."},"stage":{"default":false,"description":"Stage the matched set on a DataCanvas for SQL analysis with openfda_dataframe_query. Default false — the call returns one page for one upstream request. When true, records are also drained onto a canvas table up to a size budget (staged_rows reports how many reached it). Staging is for record-level SQL over a bounded slice; for a distribution over everything that matched, openfda_count_values aggregates server-side in one request. Requires CANVAS_PROVIDER_TYPE=duckdb.","type":"boolean"},"canvas_id":{"description":"DataCanvas session id from a prior call. Passing one stages this search onto that canvas (same effect as stage=true) so result sets accumulate for cross-table joins. Omit to stage onto a fresh canvas.","type":"string","minLength":1,"pattern":"\\S"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}}],"scan":{"score":86,"grade":"A","scanned_at":"2026-09-19T10:14:28.548Z","report":{"scannerVersion":"0.1.3","scannedAt":"2026-09-19T10:14:28.497Z","components":{"code":{"score":25,"max":25,"notes":["67 source files scanned","67 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 384ms"]},"poisoning":{"score":15,"max":15,"notes":["14 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 1 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 3 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"}],"inputs":{"probes":[{"url":"https://openfda.caseyjhand.com/mcp","reachable":true,"authRequired":false,"latencyMs":384,"serverInfo":{"name":"openfda-mcp-server","version":"0.7.5"}}],"packages":[{"registryType":"npm","identifier":"@cyanheads/openfda-mcp-server","version":"0.7.5","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-09-16T11:01:19.109Z","repositoryUrl":"git+https://github.com/cyanheads/openfda-mcp-server.git","weeklyDownloads":354},{"registryType":"npm","identifier":"@cyanheads/openfda-mcp-server","version":"0.7.5","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":4,"publishedAt":"2026-09-16T11:01:19.109Z","repositoryUrl":"git+https://github.com/cyanheads/openfda-mcp-server.git","weeklyDownloads":354}],"repo":{"found":true,"owner":"cyanheads","repo":"openfda-mcp-server","archived":false,"pushedAt":"2026-09-16T10:59:49Z","stars":4,"forks":2,"openIssues":9,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/10339515?v=4","ownerCreatedAt":"2014-12-29T13:01:12Z","license":"Apache-2.0"},"icon":{"url":"https://avatars.githubusercontent.com/u/10339515?v=4&s=128","source":"github"},"presence":{"stars":4,"forks":2,"downloadsWeek":708,"license":"Apache-2.0","lastPushAt":"2026-09-16T10:59:49.000Z","score":41}}}},"grade_history":[],"reviews":[]}