Nc Medical Exclusions

@pipeworx/nc-medical-exclusions

医療提供者または事業者の名称、NPI、または非 NPI の「非典型」Medicaid 医療提供者 ID を、ノースカロライナ州の Medicaid 医療提供者除外リストと照合します。これは、ノースカロライナ州に特化した連邦 HHS OIG LEIE の州レベル版であり、ny-omig-exclusions、ca-medical-exclusions、tx-medical-exclusions、fl-medical-exclusions、pa-medical-exclusions、ga-medical-exclusions、oh-medical-exclusions、nj-medical-exclusions の姉妹パッケージです。

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

ツール

• nc_medical_check_exclusion(name?, npi?, atypical_id?, limit?) — 医療提供者または事業者をリストと照合します。NPI または atypical-ID が一致した場合は「識別済み」です。EXCLUDED ENTITY フィールドとの名称一致は、候補となる手がかりにすぎません。NC Medicaid が公開している注記に従い、行の OWNERSHIP フィールド（参考情報として記載された所有者・代表者）にのみ一致する名称は、match_type: "ownership_only_match" と excluded:false を返し、除外と混同されることはありません。
• nc_medical_exclusion_coverage(year?, start_date?, end_date?) — 引数なしの場合、総行数、NPI が記載された行数、atypical ID が記載された行数、除外理由の種類、最も古い／新しい有効日を報告します。year または日付範囲を指定すると、その期間中に有効となった除外件数を集計します（ページ単位ではなく、リスト全体を対象に effective_date で集計します）。

認証

キーは不要です。

データソース

• NC Medicaid、Division of Health Benefits、Office of Compliance and Program Integrity — State Excluded Providers List。ノースカロライナ州の Medicaid およびその他の医療プログラムから、正当な理由により資格を停止されたサービス提供者の一覧です。ログインや CAPTCHA は不要です。

注記

• これは現在のスナップショットであり、過去に除外されたすべての提供者の履歴ではありません — TX/PA/NJ の先例パッケージとは異なります。NC Medicaid は除外終了日／復帰日を示す列を公開していません。資格が復帰した提供者は、次の月次ファイルから単に消えます（ga-medical-exclusions と同じ構成です）。そのため、このパッケージが提供するすべての行は currently_excluded:true です。
• 自宅住所は提供しません。 このデータソースには、どの行にも番地を含む住所はありません。CITY/STATE/ZIP は提供者の登録所在地であり、ga-medical-exclusions が STATE フィールドを提供するのと同程度の大まかな情報にとどまり、番地レベルの住所ではありません。
• OWNERSHIP は除外を意味しません。 NC Medicaid が公開している注意書きによると、OWNERSHIP 列の名称は、EXCLUDED ENTITY に別途記載されていない限り、除外対象ではありません。このパッケージでは、所有権に関する一致を該当事例として扱わず、一致タイプでその区別を維持します。
• 識別子が常に NPI とは限りません。 NC Medicaid の列見出しは「NPI/ATYPICAL ID (EXCLUDED)」です。大半の行には形式が正しい 10 桁の NPI が記載されていますが、一部の行には非 NPI の 8 桁の「非典型」Medicaid 医療提供者 ID が記載されています。npi と atypical_id は別々のフィールドとして保持されます。
• ソースファイル内の有効日は複数の形式で記録されています — 大半の行では Excel の日付シリアル値ですが、一部は「MM/DD/YYYY」形式の文字列です。どちらも同じ ISO 日付に変換されます。
• scripts/bake-index.mjs で更新します。このスクリプトは公開ファイルを再取得し（NC Medicaid のダウンロードリンクは安定しているため、一覧ページを再確認する必要はありません）、src/nc-dhb-index-data.ts を再生成します。定期的に再実行し、変更をコミットしてください。各レスポンスの data_as_of は、生成済みコピーがどれほど古いかを示します。

クイックスタート

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

{
  "mcpServers": {
    "nc-medical-exclusions": {
      "url": "https://gateway.pipeworx.io/nc-medical-exclusions/mcp"
    }
  }
}

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

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

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/nc_medical_check_exclusion \
  -H 'Content-Type: application/json' \
  -d '{"name":"HOSFORD"}'

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

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

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

{
  "mcpServers": {
    "nc-medical-exclusions": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nc-medical-exclusions"]
    }
  }
}

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

npx -y @pipeworx/mcp-nc-medical-exclusions

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Nc Medical Exclusions data" })

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

詳細

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

ライセンス

MIT