Uk Charity Commission

@pipeworx/uk-charity-commission

イングランドおよびウェールズ慈善委員会の英国慈善団体登録簿 — 登録慈善団体のステータス、目的、活動地域、年ごとの報告収入と支出、および氏名が登録されている受託者を確認できます。

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

ツール

• ukcharity_search(query, limit?, registered_only?, _apiKey) — 名称から慈善団体を検索します。
• ukcharity_details(charity_number, subsidiary_number?, _apiKey) — 登録簿の完全な登録情報です。
• ukcharity_financials(charity_number, subsidiary_number?, _apiKey) — 提出された収入／支出の履歴です。
• ukcharity_trustees(charity_number, subsidiary_number?, _apiKey) — 受託者会です。

認証

BYOキーを使用します。キーが発行された後は、PLATFORM_CHARITY_COMMISSION_KEY がプラットフォームのフォールバックとして使われます。それまでは、workers/gateway/src/pack-manifest.json でこのパックは byoExpected となっており、すべての呼び出しで呼び出し元が _apiKey を指定する必要があります。拒否メッセージにもその旨が明記されます。

登録は無料ですが、1ステップで即時にセルフサービス登録できるわけではありません。https://api-portal.charitycommission.gov.uk/ で登録し、「Charity Commission Register of Charities」製品を購読すると、Ocp-Apim-Subscription-Key が発行されます。キーなしでの利用やデモ用の経路はありません — ヘッダーがない場合、すべての操作で 401 Access Denied が返されます。

データソース

• https://api.charitycommission.gov.uk/register/api/searchCharityName/{text}
• https://api.charitycommission.gov.uk/register/api/allcharitydetailsV2/{number}/{subsidiary}
• https://api.charitycommission.gov.uk/register/api/charityfinancialhistory/{number}/{subsidiary}
• https://api.charitycommission.gov.uk/register/api/charitytrusteeinformation/{number}/{subsidiary}

知っておくとよいこと：

• Azure API Managementは、キーがない場合や誤っている場合に403ではなく401を返し、WWW-Authenticate: AzureApiManagementKey ヘッダーでその旨を通知します。そのため、キーの問題は明確で、権限の反映遅延と混同することはありません。
• パスが誤っている場合、キーの確認より先に404が返されます。その仕組みにより、キーを持たずに上記の操作名を確認できました。charitytrustees、charityclassification、charitypublishedreport、charityotheraddresses、charityeventhistory はすべて404を返します — これらは存在しません。実際の名前は charitytrusteeinformation、charityareaofoperation、charitygoverningdocument、charityotherregulators で、すべて401を返します（つまり存在します）。
• 慈善団体を対象とする操作はすべて、パスセグメントを2つ必要とします。登録済み慈善団体番号と子組織番号です。主たる慈善団体は 0 です。2つ目のセグメントを省略すると404が返されます。
• register-of-charities.charitycommission.gov.uk/api/search — 公開ウェブサイト独自のエンドポイント — は、このパックの構築時にAzure Application Gatewayから 502 Bad Gateway を返していたため、キーなしでのフォールバックにはなりません。

クイックスタート

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

{
  "mcpServers": {
    "uk-charity-commission": {
      "url": "https://gateway.pipeworx.io/uk-charity-commission/mcp"
    }
  }
}

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

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

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

または、Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールを一覧で直接確認できます。

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ukcharity_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"oxfam","limit":5}'

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

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

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

{
  "mcpServers": {
    "uk-charity-commission": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-uk-charity-commission"]
    }
  }
}

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

npx -y @pipeworx/mcp-uk-charity-commission

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントとゲートウェイ全体のどちらでも使えます。

ask_pipeworx({ question: "your question about Uk Charity Commission data" })

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

詳細

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

ライセンス

MIT