Fda Inspections

fda-inspections

FDA Data Dashboard（Office of Inspections and Investigations）による、FDA の査察結果、Form 483 の指摘事項、コンプライアンス対応、および輸入拒否です。

Pipeworx の一部です。AI エージェントを1679以上の稼働中のデータソースに接続するMCPゲートウェイです。

これは openFDA ではありません。 openFDA には、医薬品・医療機器の有害事象、ラベル、リコール、警告書が含まれています。査察分類、483 の指摘事項、国境での輸入拒否は含まれていません。これらは、ホストと認証情報が異なる OII 独自の Data Dashboard にのみあります。

ツール

ツール	回答する内容
fda_inspections	この施設は査察を受けましたか？結果（NAI / VAI / OAI）は何ですか？
fda_483_citations	指摘された理由は何ですか？該当する CFR の条項と、調査官が記載した内容は何ですか？
fda_compliance_actions	その後、どのような執行措置が取られましたか？警告書、差止命令、押収、資格剥奪のいずれですか？
fda_import_refusals	国境で拒否された貨物は何ですか？どのような違反に基づくものですか？
fda_firm_risk_profile	1つの製造業者について、FEI の施設情報を解決したうえで、4項目すべてをまとめて確認できます。

認証

認証情報は単一のキーではなく、ペアです。

Authorization-User: <the e-mail it was issued to>
Authorization-Key:  <the FDA-generated key>

_apiKey に結合形式の "email:key" として渡します（最初のコロンで分割します）。プラットフォームシークレットは PLATFORM_FDA_DASHBOARD_KEY です。同じ結合形式で、gateway と registry-api の両方のワーカーに設定してください。

認証情報は無料です。OII Unified Logon アプリケーション（https://www.accessdata.fda.gov/scripts/oul）でアカウントを作成し、Data Dashboard API へのアクセスを申請してください。FDA は登録したメールアドレスにキーを送信し、そのアドレスが Authorization-User の値になります。プラットフォーム認証情報は設定済みのため、呼び出し側で独自のキーを用意する必要はありません。

datadashboard.fda.gov は、デフォルトの curl User-Agent に対して 403 を返します。ドキュメントを手動で読む際は、ブラウザーの UA を送信してください。API ホスト（api-datadashboard.fda.gov）にはこの制限はありません。

リクエストの仕様

想定ではなく、稼働中のエンドポイントで検証済みです。不正なリクエストボディは 400 を返し、問題のあるフィールド名を示します。形式は正しいものの認証されていないリクエストは 401 を返すため、認証情報がなくてもリクエスト形式をテストできます。

• POST https://api-datadashboard.fda.gov/v1/<resource>
• ボディ：{ start, rows, sort, sortorder, columns[], filters{} }
• sort と sortorder は必須で、省略できません。
• start は1から始まります。
• rows の上限は 5000 です。
• columns は必須です。省略すると 400 が返り、不足しているフィールド名が示されます。
• フィルター値は配列である必要があります（{"State": ["California"]}）。文字列を直接指定すると 400 が返ります。
• 日付範囲には接尾辞付きのキーを使用します：InspectionEndDateFrom / InspectionEndDateTo。トップレベルの日付範囲パラメーターはなく、接尾辞のない日付フィールド名はフィルターキーとして拒否されます。
• ほとんどの文字列フィルターは、大文字と小文字を区別せず LIKE %term% で照合されます。そのため、企業名は部分一致検索になります。例外は State です。詳細は以下を参照してください。

注意点：State は完全一致であり、誤った値を指定すると「査察歴なし」のように見えます

LegalName、FirmName、CountryName は、大文字と小文字を区別しない部分一致です。State は正式名称に対する、大文字と小文字を区別する完全一致です。 "CA"、"Ca"、"CALIFORNIA" はいずれも resultcount: 0 で正常に 200 を返します。その結果、引数を間違えて指定したのではなく、この施設は一度も査察を受けていないように見えてしまいます。データが返されるのは "California" だけです。

このパックは郵便番号と大文字・小文字の表記を正規化する（normalizeState）ため、呼び出し側ではどちらの形式でも指定できます。国外の施設では State: null となるため、代わりに country で絞り込んでください。

注意点：企業名検索は部分一致のため、対象が広くなりすぎます

firm: "Intas" は Cintas Corporation にも一致します。fda_firm_risk_profile は、照合された FEI をすべて matched_establishments で返すため、この点を確認できます。すべての一致行に基づいて集計された件数を引用する前に、この一覧を確認してください。

注意点：名前の列は統一されていません

import_refusals では FirmName を使用します。他の3つのリソースでは LegalName を使用します。誤った列名を送信すると無効なフィールド名として拒否されるため、 このパックでは一律の列名を仮定せず、リソースごとに名前の列を指定しています。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "fda-inspections": {
      "url": "https://gateway.pipeworx.io/fda-inspections/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/fda-inspections/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールも返します — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールです。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、およそ30個の共有ツールが一覧表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、ask_pipeworx でカタログ全体を検索し、このパックでは対応していない質問にも答えられます。2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマが、ルーティングの利点よりも多くのコンテキストを消費する場合は、複数のパックエンドポイントではなく、完全なゲートウェイに一度だけ接続してください。

または、Pipeworx の完全なゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ1679以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらから接続しても、ask_pipeworx ですべてのツールを利用できます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/fda_inspections \
  -H 'Content-Type: application/json' \
  -d '{"firm":"Intas","limit":25}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには GET https://gateway.pipeworx.io/v1/tools/fda_inspections を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイとの往復通信も必要ありません：

{
  "mcpServers": {
    "fda-inspections": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-fda-inspections"]
    }
  }
}

または、起動を確認するために直接実行します：

npx -y @pipeworx/mcp-fda-inspections

stdin／stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使用しますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでも完全なゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Fda Inspections data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT