Eu Ctis

@pipeworx/eu-ctis

規則 536/2014 に基づき EU／EEA で承認された臨床試験を、EU 臨床試験情報システム（CTIS）から取得します。どの試験が、どの加盟国で、どの疾患を対象に、どのステータスで実施されているかを確認できます。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中データソースに接続する MCP ゲートウェイです。独立した非公式の統合であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• ctis_search_trials(query?, medicine?, condition?, sponsor?, title?, endpoint?, exclude?, status?, phase?, country?, age_group?, region?, gender?, has_results?, rare_disease?, orphan_designation?, low_intervention?, start_from?, start_to?, sort_by?, sort_direction?, page?, limit?) — あらゆる条件で検索できます。「この薬を対象として、欧州で参加者を募集している試験はどれか」という質問に答えます。
• ctis_trial(ct_number) — 1 件の試験の公開記録をすべて取得します。タイトル、スポンサー、製品と有効成分、疾患、目的、参加資格基準、評価項目、予定登録数、加盟国ごとのステータスと決定日、報告された開始・募集イベントが含まれます。
• ctis_trials_for_medicine(medicine, recruiting_only?, country?, limit?) — 特定の薬剤または有効成分が関係する EU の全試験を、ステータス別の件数とともに取得します。
• ctis_recent_authorisations(since?, country?, condition?, sponsor?, phase?, limit?) — EEA で最近承認された試験を、決定日の新しい順に取得します。

認証

キーは不要です。API キー、Cookie、ブラウザーの User-Agent は必要ありません。

データソース

• POST https://euclinicaltrials.eu/ctis-public-api/search — 検索エンドポイントです。JSON のリクエスト本文を送信し、JSON を受け取ります。
• GET https://euclinicaltrials.eu/ctis-public-api/retrieve/{ctNumber} — 1 件の試験の完全な記録を取得します。
• 人間向けの公開ポータル：https://euclinicaltrials.eu/ctis-public/search。

触れる前に知っておくべきこと

• /ctis-public-api/search への GET は 403 を返します。 検索は POST です。403 は認可の壁ではなく、メソッドの不一致です。外から見るとまさに認可の壁のように見えるため、このデータソースは以前、一度却下されました。
• 兄弟パスは HTML を含む 200 を返します。 /ctis-public-api/search/{ctNumber}、/trial/{ctNumber}、/ct/{ctNumber} は、いずれも Angular SPA のインデックスページを 200 で返します。JSON を返すのは /retrieve/{ctNumber} だけです。ステータスコードを信頼するパーサーは、HTML のシェルをデータとして解析してしまいます。
• 不明な試験番号は 404 ではなく、200 と {} を返します。 本文に ctNumber がないことだけが、「見つからない」ことを示す唯一のシグナルです。
• フィルターはテキストではなく、数値コードのリストです。 status、trialPhaseCode、ageGroupCode、msc（加盟国。ISO 3166 の numeric 国コード）および trialRegion は、すべて整数を受け取ります。語彙は src/index.ts にあり、ポータル独自の選択肢リストから取得されています。ツールは人が読むラベルを受け取り、コードに対応付けます。
• 全体のステータスコードと国ごとのステータスコードは、同じ語彙を共有します（1 = 評価中 … 12 = 取消済み。加えて、加盟国ごとに 13～18 が使われます）。検索結果の trialCountries は "Spain:2" のように、国名、コロン、その国のステータスコードで構成されます。
• ctStatus は、場所によって意味が異なります。 検索結果では数値コードですが、取得ペイロードでは、より大まかなラベル文字列（"Authorised"）で、数値コードは ctPublicStatusCode に格納されています。どちらも出力時にラベルへ正規化されます。
• 日付はエンドポイントによって異なります。 検索結果は DD/MM/YYYY、詳細は ISO タイムスタンプです。出力時にはすべて ISO 日付になります。
• 完全なレコードは大きくなります。16 か国のフェーズ III の場合は 220 KB です。各自由記述フィールドに、該当するすべての言語への翻訳が含まれるためです。詳細ツールはデータをフラット化し、翻訳を削除します。
• 試験には ClinicalTrials.gov の番号が含まれます。secondaryIdentifyingNumbers.nctNumber にあり、nct_number として公開されます。これは、同じ試験の clinicaltrials パックと結合するためのキーです。
• CTIS は 2022 年に始まりました。 規則 536/2014 は 2022 年 1 月 31 日から適用されます。旧指令に基づいて承認された試験は、旧 EU Clinical Trials Register に登録されており、ここにはありません。
• trialGlobalEnd は、試験の実施中は配列で、終了後はオブジェクトです。

クイックスタート

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

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

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

https://gateway.pipeworx.io/eu-ctis/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 も、同じゲートウェイと同じ 1879 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ctis_search_trials \
  -H 'Content-Type: application/json' \
  -d '{"medicine":"pembrolizumab","status":["Ongoing, recruiting"],"country":["Germany"],"limit":2}'

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

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

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

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

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

npx -y @pipeworx/mcp-eu-ctis

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Eu Ctis data" })

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

詳細

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

ライセンス

MIT