Ca Grants

@pipeworx/ca-grants

California Grants Portal MCP — カリフォルニア州の助成金募集情報を公開しています。運営機関、応募資格、利用可能な資金額、申請期限を確認できます。キー不要です。

Pipeworx の一部です。AI エージェントを 1875+ の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとの提携、承認、公開を受けたものではありません。

ツール

• ca_search_grants(query?, status?, category?, applicant_type?, limit?, offset?) — カリフォルニア州の助成金募集情報を自由記述で検索します。ステータス、カテゴリ、応募資格のある申請者の種類で絞り込めます。デフォルトは status="active" です。
• ca_get_grant(portal_id) — 1 件の助成金の全記録を取得します。目的、説明、応募資格に関する注記、対象地域、資金源、マッチング資金の要件、助成額、資金提供方法、連絡先情報、リンクが含まれます。
• ca_grants_closing_soon(days?, category?, applicant_type?, limit?) — 今後 N 日以内（デフォルトは 30 日）に固定の締切がある募集中の助成金を、締切が近い順に取得します。また、締切が随時の Ongoing の募集件数も表示します。
• ca_grants_by_agency(agency, status?, limit?, offset?) — カリフォルニア州の部局・機関 1 つからの助成金を取得します。大文字と小文字を区別しない部分一致で柔軟に照合し、ステータスの内訳も表示します。
• ca_list_grant_categories(status?) — データに実際に含まれるカテゴリ、申請者の種類、機関、ステータスの値を、それぞれの助成金件数とともに表示します。実データから絞り込み値を確認できます。

認証

キー不要です。API キーも、独自の認証情報も必要ありません。

データソース

• データセット：https://data.ca.gov/dataset/california-grants-portal
• エンドポイント：https://data.ca.gov/api/3/action/datastore_search
• リソース ID：111c8c88-21f6-453c-ae2c-b4785a0624f5（約 1,974 件、毎日更新）
• 一般向けポータル：https://www.grants.ca.gov/

注意点

フィールド ID は TitleCase（AgencyDept、ApplicationDeadline、EstAvailFunds）です。大文字・小文字を間違えると、エラーではなく CKAN が何も返さないため、このパック内のフィールド名はすべてライブの fields リストに基づいています。すべての値はテキストとして保存されており、これには 3 つの影響があります。EstAvailFunds は "$750,000" のような表示用文字列で、EstAmounts は "Between $1 and $375,000" のような範囲であることが多いため、このパックでは数値による最低額フィルターをあえて提供していません。そのようなフィルターは範囲を推測する必要があるためです。est_available_funds_approx は参考情報として先頭の金額を解析しますが、絞り込みには使用しません。Categories と ApplicantType はセミコロン区切りのリスト（"Nonprofit; Public Agency; Tribal Government"）であるため、CKAN の filters は完全一致または IN 条件しか処理できません。そこで、クライアント側で個々の値に分割し、大文字・小文字を区別せずに照合します。また、ApplicationDeadline はテキストです。通常は "YYYY-MM-DD HH:MM:SS" ですが、現在募集中の 177 件のうち 127 件は、文字列 "Ongoing"（随時受付、締切なし）をそのまま保持しており、1 件は null です。そのため、締切の計算はクライアント側で行い、ca_grants_closing_soon は募集中の助成金の 3 分の 2 を取りこぼさないよう、ongoing_no_deadline を独立した区分として報告します。締切のタイムスタンプにタイムゾーンは含まれず、UTC として扱います。これは 1 日以内の精度です。Status の値は 3 種類（active 177 件、closed 1,796 件、forecasted 1 件）に限られているため、フィルターなしの検索では期限切れの募集が大半を占めます。そのため、ca_search_grants はデフォルトで active を指定します。CKAN は部分一致に対応していないため、ca_grants_by_agency は射影スキャン 1 回で、呼び出し元が指定した文字列を 73 種類の AgencyDept 値と照合し、一致した正確な名称を使ってサーバー側で絞り込みます。

クイックスタート

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

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

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

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

これは意図的な設計であり、意図せず多重化されているわけではありません。スコープを絞った接続から、このパックでは対応できない質問にも答えられるのは、メタツールがあるためです。ask_pipeworx を通じてカタログ全体を検索できるので、MCP サーバーを 2 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度接続してください。

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

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

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

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/ca_search_grants \
  -H 'Content-Type: application/json' \
  -d '{"query":"wildfire resilience","status":"active","limit":10}'

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

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

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

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

起動を確認するには、直接実行することもできます。

npx -y @pipeworx/mcp-ca-grants

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問することもできます。これは、上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Ca Grants data" })

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

詳細

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

ライセンス

MIT