Documentation

Connect the FDA record to your agent.

Connect once, start with a company-level manufacturing and compliance summary, then drill into inspections, warning letters, OII records, facilities, import risk, and product data as needed.

Jump to section
01First call

Start here

  1. Pick the app you use

    Each link opens the setup steps for that app. What the server covers is on the FDA MCP server page.

  2. Sign in when the app asks

    A free account needs no card and starts with 50 credits. Building on the API instead? Get a key at /signup. Plan limits and the credit cost of each tool are on pricing.

  3. Ask a first question

    Try one of the prompts below, with a company you already know.

Evaluating a company for manufacturing, compliance, diligence, or account research? Start with fda_manufacturing_risk_summary, then follow the trail.

  • Start with fda_manufacturing_risk_summary when you need a fast company-level view.
  • Use fda_facility_dossier when you already know the FEI and want the local compliance story fast.
  • Use fda_company_compliance_timeline when you want one dated event stream across inspections, warning letters, import risk, and recalls.
  • Use inspections, citations, warning letters, OII, import alerts, and debarments after the workflow tools when you need raw evidence.
  • Use product, label, approval, shortage, and recall tools after you know which business unit or facility you care about.
Walk through a first question in Claude, with a real answer
Prompt

“Give me a manufacturing risk summary for Pfizer.”

Prompt

“Summarize recent warning letters, inspections, and import alerts for Moderna.”

Prompt

“Show manufacturing risk summary plus recent OII records for Thermo Fisher.”

02Access

Authentication

Provision a key on /signup. There are two ways to use it:

  • OAuth sign-in (claude.ai and ChatGPT connectors). Add the plain URL https://www.regdatalab.com/mcp as a custom connector and keep the sign-in settings the client detects. RegDataLab opens a sign-in page: enter your email and open the link we send in the same browser. No account yet? Approving the connection creates a free one. Pasting an API key works too. The server then issues the connector its own tokens, so a key never goes in the URL.
  • Bearer header (everything else). Claude Desktop, Claude Code, Cursor, JSON configs, and raw HTTP clients send the key in the Authorization or x-api-key header. Persist the session id returned by initialize for the life of the connection. A client that can only take a URL signs in with OAuth at https://www.regdatalab.com/mcp. The server refuses a key placed in the URL query string with HTTP 400.

The key on the homepage is a shared demo key. It is not a personal key: every visitor uses the same credential, it is limited to 10 requests per minute and 50 credits per IP address, and it can only call the public FDA tools. Sign up for your own key to keep credits and account access private.

HTTP headers
Authorization: Bearer fda_...
# or: x-api-key: fda_...

# Persist the session id returned by initialize:
Mcp-Session-Id: <session_id>
03Setup

Connect your client

RegDataLab speaks the Model Context Protocol over one HTTP endpoint. Start with claude.ai or ChatGPT for a zero-install connection, or wire it into Claude Desktop, Claude Code, Cursor, VS Code, Codex, the OpenAI API, or your own pipeline. Every one of those signs in, so no key has to go into a config file. In the key-based examples, replace YOUR_API_KEY with the key from /signup.

No install

Other clients

A

Connect in claude.ai (no install)

The fastest path — nothing to install, works in any modern browser.

FDA company records in Claude

  1. 01Open claude.ai/directory/regdatalab and click Connect (Team and Enterprise: an owner adds it in Organization settings → Connectors first, then you click Connect)
  2. 02On the RegDataLab page that opens, enter your email and open the sign-in link we send in the same browser (no account or API key needed; pasting a key works too), then approve
  3. 03In a chat, turn RegDataLab on under + → Connectors
  4. 04Listing not shown for you? Customize → Connectors → Add custom connector, name it RegDataLab and paste this URL instead
Connector URL
https://www.regdatalab.com/mcp

Free plans can add one custom connector.

    Troubleshooting

    Tools not showing after setup
    Restart the client after editing its config, then confirm regdatalab appears in the connector or MCP server list. In Claude, turn the connector on in the chat under + → Connectors. In ChatGPT, install the plugin and type @RegDataLab in the chat.
    Invalid API key or “This API key is not recognized”
    The key was replaced (for example by key recovery), its account was deleted, or it was copied incompletely. Get your current key from /account; if you use a hosted MCP service, update the key saved there too. Confirm the Bearer token is the full key from /signup with no spaces or line breaks. For claude.ai and ChatGPT connectors, disconnect and sign in again, then paste the full key on the RegDataLab page.
    Claude.ai detected “No sign-in”
    Remove the connector and add it again with the exact URL https://www.regdatalab.com/mcp, then choose Sign in now as the authentication. On the RegDataLab page, enter your email and open the sign-in link we send, or paste your API key.
    npx or fda-data-mcp not found
    Install Node.js, then test the wrapper directly: FDA_DATA_API_KEY=YOUR_API_KEY npx -y fda-data-mcp. Wrapper documentation: https://github.com/medley/fda-data-mcp
    Session expired
    Re-initialize by restarting the client. Most clients handle session renewal automatically.
    04Practice

    Search tips

    Better matching
    • Use the most canonical company name you know first, then confirm aliases or subsidiaries before widening the search.
    • For large parents, drill down into a specific subsidiary, brand, FEI, or geography when broad name matching brings back noise.
    • Avoid firing many heavy tools in parallel until you know which company entity and question you actually want to pursue.
    • Use fda_resolve_company to jump straight to the right corporate family and its sites.
    Credits & pacing
    • Credits are consumed per tool call that runs, including empty or not-found results.
    • Calls rejected for invalid or missing input, and calls that fail with an internal server error (code internal_error), are refunded.
    • When credits are exhausted the API returns HTTP 402 with a no_credits-style error instead of silently failing.
    • New keys start with 50 credits at signup; verify your email to unlock 300 credits a month, at 60 requests per minute.
    05Audience

    Who it helps

    Built first for manufacturing and supplier-quality questions about companies and facilities. The same records also support the workflows below.

    Manufacturing and quality teamsResearchersJournalistsInvestorsSales teams
    06Reference

    Tool reference

    51 MCP tools, organized by category. Claude and ChatGPT connectors list all 51, as do API-key sessions. Start with the manufacturing summary for a fast company view, then reach for the drill-down tools when you need raw evidence. Each row shows the credits one call uses (also listed on Pricing).

    02Start Here

    Start Here tools
    ToolDescriptionCredits
    fda_manufacturing_risk_summaryBest first tool for a company-level manufacturing and compliance summary across inspections, warning letters, OII records, import risk, debarments, facilities, and recalls.3 credits
    fda_compare_companiesCompare 2 to 5 companies side by side in one call: facilities, inspection classifications, warning letters, the latest Form 483, import alerts and refusals, debarments and recalls, each with its most recent date.6 credits

    14Manufacturing & Compliance

    Manufacturing & Compliance tools
    ToolDescriptionCredits
    fda_inspectionsSearch FDA inspections by company, FEI, date, and geography. NAI means no objectionable conditions or practices were found during the inspection. VAI means objectionable conditions or practices were found, but the agency is not prepared to take or recommend any administrative or regulatory action. OAI means regulatory and/or administrative actions are recommended.1 credit
    fda_inspection_statsCount FDA inspections by fiscal year and outcome (OAI, VAI, NAI) with the OAI share, filtered by product type, project area or country.1 credit
    fda_citationsSearch inspection citations and CFR findings tied to facilities and companies.1 credit
    fda_compliance_actionsSearch warning letters, seizures, and injunctions from FDA compliance dashboards.1 credit
    fda_search_warning_lettersSearch FDA warning letters with dates, issuing office context, and text or excerpts where captured.1 credit
    fda_search_oii_recordsSearch OII reading-room records, including machine-readable inspection and compliance documents.1 credit
    fda_search_debarmentsSearch FDA debarment records and integrity-related exclusions.1 credit
    fda_search_import_alertsSearch import alerts, red-list and green-list placements, and linked firms.1 credit
    fda_search_opdp_untitled_lettersSearch OPDP untitled letters for pharma promotional and commercial compliance issues.1 credit
    fda_bpdr_summaryReview BPDR annual summary data for biologics manufacturing and quality signal context.1 credit
    fda_device_supply_statusCheck device supply disruption and shortage signals for medtech manufacturing monitoring.1 credit
    fda_inspection_observation_summaryReview annual inspection observation summary trends and common citation patterns.1 credit
    fda_import_refusalsSearch import refusal records by company, FEI, country, category, and date.1 credit
    fda_ires_enforcementSearch iRES enforcement and recall records from FDA internet Recall Enterprise System data.1 credit

    10Company & Facility Intelligence

    Company & Facility Intelligence tools
    ToolDescriptionCredits
    fda_lookup_companyQuick company view across facilities, enforcement history, and alias resolution.1 credit
    fda_search_facilitiesSearch FDA facilities by company, location, and operating context.1 credit
    fda_get_facilityOpen a detailed facility record by FEI, including linked enforcement context.1 credit
    fda_facility_productsList products and classifications linked to a facility.1 credit
    fda_resolve_companyResolve a company to its normalized aliases and canonical record.1 credit
    fda_suggest_subsidiariesSuggest likely subsidiaries and brand/entity relationships from FDA and EDGAR-style evidence.2 credits
    fda_company_fullPull a broader company profile across facilities, recalls, approvals, and drug/device coverage.5 credits
    fda_company_compliance_timelineOne reverse-chronological event stream across inspections, warning letters, import risk, debarments, and recalls.2 credits
    fda_facility_dossierFull compliance dossier for one facility by FEI: inspections, citations, warning letters, recalls, and import risk in a single call.1 credit
    fda_search_family_facilitiesMap a company's entire manufacturing footprint across its resolved corporate family.1 credit

    12Products, Approvals & Labels

    Products, Approvals & Labels tools
    ToolDescriptionCredits
    fda_search_510kSearch FDA 510(k) clearances by company, product code, and decision details.1 credit
    fda_search_pmaSearch FDA PMA approvals by company, product code, and decision window.1 credit
    fda_search_drugsSearch Drugs@FDA applications, brand names, and submission status.1 credit
    fda_search_ndcSearch the NDC directory by labeler, brand, or application number.1 credit
    fda_search_nsdeSearch NDC SPL Data Element (NSDE) records by name, package NDC, and application number. A listing does not indicate FDA approval.1 credit
    fda_search_by_productSearch across drug and device product-oriented datasets by product name.2 credits
    fda_device_classLook up device classification details by product code.1 credit
    fda_product_code_lookupCross-reference a product code across classification, 510(k), and PMA data.1 credit
    fda_clinical_result_lettersSearch Complete Response Letters and related FDA transparency records.1 credit
    fda_drug_labelsSearch SPL drug labels, sections, manufacturers, and application references.1 credit
    fda_device_udiSearch the FDA UDI dataset for device identifiers, companies, and product codes.1 credit
    fda_device_udi_lookupLook up GUDID-style UDI records directly.1 credit

    08Recalls, Safety & Specialty

    Recalls, Safety & Specialty tools
    ToolDescriptionCredits
    fda_search_enforcementSearch recall and enforcement actions across drug, device, and food records.1 credit
    fda_search_recall_textSearch recall reason text and product descriptions across enforcement records.1 credit
    fda_recall_facility_traceTrace recalls back to likely facilities and manufacturing entities.2 credits
    fda_drug_shortagesSearch active and resolved FDA drug shortages.1 credit
    fda_device_recallsSearch device recall records with firm, product code, and status filters.1 credit
    fda_adverse_eventsSearch consumer (food, cosmetic), veterinary and tobacco adverse event reports.1 credit
    fda_substance_lookupLook up FDA substance and UNII data by code or name.1 credit
    fda_search_aphisSearch USDA APHIS veterinary biologics establishments. USDA records, not FDA data.1 credit

    05Software Research (MES, QMS, LIMS)

    Software Research (MES, QMS, LIMS) tools
    ToolDescriptionCredits
    software_search_productsSearch the public-source MES, QMS, LIMS and adjacent software dossiers by text and category.1 credit
    software_get_productProfile summary, pricing stance, review status and key claims with sources for one product.1 credit
    software_compareCompare 2 to 5 products side by side on deployment, pricing stance and regulatory posture.1 credit
    software_list_evidenceList a product's sourced claims by topic or source type, each with its URL and confidence.1 credit
    software_get_sourcesRead a product's sources note: each source and what it supports.1 credit
    07Limits

    Rate limits

    Rate limits are enforced per API key. Each key defaults to 60 requests per minute. The shared homepage demo key is not a personal key and is capped at 10 requests per minute and 50 credits per IP address, with 60 requests per minute shared by all visitors. When a limit is exceeded, the API returns HTTP 429 with the reset window in the response headers.

    Response headers
    X-RateLimit-Limit: 60
    X-RateLimit-Remaining: 42
    X-RateLimit-Reset: 1708905600
    08Failure

    Errors

    Errors use standard HTTP codes with JSON payloads.

    Error codes
    CodeDescription
    401 / 403Authentication failure — invalid or missing API key.
    402Credits exhausted (REST API) — verify your email if you have not, upgrade to a paid plan on the pricing page, or wait for the monthly reset. MCP clients stay connected and the tool call itself reports the same thing.
    429Rate limit exceeded — retry after the reset window.
    500Internal error — retry or contact support.
    09Provenance

    Data sources

    RegDataLab ingests openFDA bulk downloads, DECRS facility data, FDA Dashboard compliance feeds, warning letters, OII reading-room records, import alerts, debarments, APHIS veterinary biologics data, and iRES enforcement reports. Each dataset is normalized with provenance metadata including source, ingested_at, and run_id.