Aphis Animal Care

@pipeworx/aphis-animal-care

USDA動物福祉法のライセンス保有者および登録者である、商業用犬ブリーダー、ディーラー、展示業者、運送業者、研究施設と、それらについて作成されたAPHIS Animal Careの検査報告書、重大／直接違反件数、および公式署名済み報告書PDFへのリンクです。

Pipeworxの一部です。AIエージェントを1872以上の稼働中のデータソースにつなぐMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携関係になく、承認も受けておらず、公開元でもありません。

ツール

• aphis_licensee_search(state?, license_type?, name?, city?, zip?, certificate_number?, customer_number?, kind?, status?, limit?, page?) — AWAライセンスまたは登録の保有者を検索します。「ミズーリ州のUSDA認可犬ブリーダー」、「証明書43-A-6814を検索」、「この犬舎はUSDAの認可を受けているか」といった検索に対応します。名前、証明書番号、ライセンス区分、証明書のステータス（有効／取消／失効）、施設の市区町村／郡／ZIPコードを返します。
• aphis_inspection_reports(state?, license_type?, name?, city?, zip?, certificate_number?, customer_number?, animal_category?, citation?, teachable_moments_only?, limit?, page?) — Animal Careの検査報告書を検索します。検査日、ライセンス保有者、所在地、重大／直接／非重大違反および指導的事項の件数、そしてreport_pdf_url（公式の署名済み報告書）が含まれます。
• aphis_inspection_filter_options(query?, kind?, limit?) — 検査フィルターで使用できる34の動物カテゴリと2,165のAWA引用条項コードを返します。

認証

キー不要です。アカウント、Cookie、セッショントークンは必要ありません。

データソース

• https://efile.aphis.usda.gov/PublicSearchTool/s/sfsites/aura — USDA APHIS eFile Public Search Toolの背後にあるAuraエンドポイントです。使用するアクション： apex://EFL_PSTController/ACTION$doCustomerQuery（ライセンス保有者／登録者）、 …$doIRSearch_UI（検査報告書）、…$getSearchSetup（州およびライセンス種別の語彙）、 …$getIRSearchFilters（動物カテゴリ、引用条項コード）。

次の人が苦労して知ることになる情報

このデータについて、文書化された REST API はなく、キーもありません。Public Search Tool は Salesforce Lightning のコミュニティで、検索は Aura エンドポイント上で実行されます。Apex クラスとメソッドは、CDP 経由でヘッドレス Chrome を操作して実際の検索を 1 回実行し、通信上のリクエストを読み取って特定しました。Apex クラス名を当てずっぽうに推測しても機能しません。誤ったクラスやメソッドを指定すると、バイト単位で同一の No apex action available for X.y が返されるためです。

• 「Guest user access is not allowed」はポリシーによるブロックではありません。 不正な形式の、または欠落した aura.context は、記述子 aura:invalidSession とともにこのメッセージを返します。これは匿名ユーザーを拒否しているように見えますが、実際にはそうではありません。エンドポイントはゲストにもデータを提供します。2026-09-05 に確認したところ、aura.context に必要なのは {"mode":"PROD","app":"siteforce:communityApp"} だけです。
• fwuid は影響しません。 不正な fwuid を指定した場合も、省略した場合も、どちらも SUCCESS が返されます。そのため、このパックはページからフレームワークのバージョンを取得せず、Salesforce の更新によって動作しなくなることもありません。
• index はページ番号であり、行のオフセットではありません。 また、上流側では基礎となる SOQL オフセットが 2,000 行に制限されています。つまり、page * page_size <= 2000 です。この上限を超えると、Maximum SOQL offset allowed for apiName EFLLicense__c is 2000 がスローされます。totalCount はページング前の正確な件数のままです（ミズーリ州だけでも Class A の繁殖者ライセンスが 4,986 件あります）。ページを進めるのではなく、絞り込んでください。
• irFilterCriteria のキーは単数形です。 animalCategory と sectionCode はそれぞれ Salesforce ID を 1 つ受け取ります。複数形の animalCategories: [id] は無視され、200 とともに フィルターされていない 件数が返されます。エラーではなく、気づきにくい誤った結果です。
• 検査検索に日付フィルターはありません。 inspectionDateFrom、fromDate、startDate はすべて無視されます。呼び出し側で inspection_date に基づいてフィルターしてください。
• ライセンスレコードは事業者そのものではありません。 1 人が証明書ごとに 1 回表示され、どの州でもレコードの大半は過去の Cancelled ライセンスです。「現在ライセンスを保有している人」を調べるには、status: "active" が重要な引数です。
• sObjectType で登録簿を選択します。EFLLicense__c は Class A/B/C のライセンス保有者、EFLRegistration__c は登録者（研究施設、運送業者、中間取扱業者）です。

クイックスタート

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

{
  "mcpServers": {
    "aphis-animal-care": {
      "url": "https://gateway.pipeworx.io/aphis-animal-care/mcp"
    }
  }
}

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

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

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、全カタログを横断してルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーを 2 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 1 回接続してください。

または、フル Pipeworx ゲートウェイに接続して、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

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

どちらの URL も、同じゲートウェイと同じ 1872+ のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらから接続しても、ask_pipeworx を使えばすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/aphis_licensee_search \
  -H 'Content-Type: application/json' \
  -d '{"state":"Missouri","license_type":"BREEDER","status":"active","limit":5}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/aphis_licensee_search を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

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

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

{
  "mcpServers": {
    "aphis-animal-care": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-aphis-animal-care"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-aphis-animal-care

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

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Aphis Animal Care data" })

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

詳細

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

ライセンス

MIT