jgrants-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jgrants-mcp 「省エネ」で受付中の補助金を締切が近い順に探して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
jgrants-mcp
デジタル庁の補助金電子申請システム「Jグランツ」の公開APIから、国や自治体の補助金を検索し、公募の詳細(対象条件・補助率・上限額・募集期間・公募要領)を取得できます。申請や採択実績の取得はできません(読み取り専用)。
MCP登録 · CLI · Pythonライブラリ
利用前に
uv と Git が必要です。Python 3.12以上に対応しています。APIキーの設定は不要です(公開APIを認証なしで呼びます)。
Related MCP server: Japan Subsidy Search MCP
MCPクライアントに登録する
公開GitHubリポジトリから uvx で起動します。初回は依存関係の準備に時間がかかることがあります。
Codex
codex mcp add jgrants-mcp -- uvx --python 3.12 --from git+https://github.com/koizumikento/jgrants-mcp.git@main jgrants-mcp
codex mcp listcodex mcp list で登録を確認し、Codexの新しいセッションで /mcp を開くと、接続状態を確認できます。Codexの公式設定ガイド
Codexのデスクトップアプリでは、設定の「MCP servers」でSTDIOサーバーを追加し、下のJSON例と同じコマンド・引数を指定する方法もあります。
Claude Desktop / Cursor
次のファイルに設定します。
Claude Desktop(Windows)
%APPDATA%/Claude/claude_desktop_config.jsonClaude Desktop(macOS)
~/Library/Application Support/Claude/claude_desktop_config.jsonCursor
.cursor/mcp.json(プロジェクト内)
既に mcpServers がある場合は、その中にサーバーの項目を追加してください。保存後にクライアントを再起動し、ツールが表示されるか確認します。設定ファイルの場所と接続手順
{
"mcpServers": {
"jgrants-mcp": {
"command": "uvx",
"args": [
"--python",
"3.12",
"--from",
"git+https://github.com/koizumikento/jgrants-mcp.git@main",
"jgrants-mcp"
]
}
}
}uvx が見つからない場合は、設定のコマンドに実行ファイルの絶対パスを指定してください。
登録後は、チャットで次のように聞けます。
東京都で受付中の、人材育成に使える補助金を探して。
「省エネ」で検索して、締切が近い順に並べて。
ツール
search_subsidies
補助金をキーワードで検索します。一覧の検索はAPIの仕様でキーワード(2文字以上)が必須で、キーワードなしの全件取得はできません。ページ送りはなく、条件に合う全件が1回で返ります。
引数 | 必須 | 内容 |
| ○ | 検索キーワード(2〜255文字) |
|
| |
|
| |
|
| |
| 業種での絞り込み(APIの定義値) | |
| 利用目的での絞り込み(APIの定義値) | |
| 従業員数の条件(APIの定義値) | |
| 補助対象地域(例: 東京都) |
返却値には件数と、各補助金のID・タイトル・補助上限額・対象地域・従業員数の条件・受付開始/終了日時が入ります。
get_subsidy_detail
補助金IDを指定して詳細を1件取得します。
引数 | 必須 | 内容 |
| ○ |
|
|
|
返却値には、制度名、概要、公募要領の本文(HTMLをプレーンテキスト化したもの)、利用目的、対象業種、従業員数の条件、補助上限額、補助率、公式ページのURL、募集の回(workflow)ごとの対象地域・受付期間・事業終了期限が入ります。V2では地域と期間が回ごとに分かれ、V1では公募直下の値を workflow 1件に正規化して返します。添付ファイル(公募要領・申請様式)は本体(Base64)を返さず、ファイル名などのメタデータのみを返します。
CLIで使う
# 受付中の補助金を締切が近い順に検索
uvx --from git+https://github.com/koizumikento/jgrants-mcp.git@main jgrants-mcp search-subsidies --keyword 省エネ --acceptance 1
# 地域で絞る(受付前・終了分も含む)
uvx --from git+https://github.com/koizumikento/jgrants-mcp.git@main jgrants-mcp search-subsidies --keyword DX --acceptance 0 --target-area-search 東京都
# 詳細を1件取得
uvx --from git+https://github.com/koizumikento/jgrants-mcp.git@main jgrants-mcp get-subsidy-detail --subsidy-id a0WJ200000CDXvUMAX引数なしで起動するとMCPサーバー(stdio)として動作します。serve を付けても同じです。
Pythonライブラリとして使う
import asyncio
from jgrants_mcp import get_subsidy_detail, search_subsidies
async def main() -> None:
result = await search_subsidies("省エネ", acceptance=1)
for item in result["items"]:
print(item["id"], item["title"], item["acceptance_end_datetime"])
detail = await get_subsidy_detail(result["items"][0]["id"])
print(detail["subsidy_rate"], detail["workflow"])
asyncio.run(main())データについて
出典はデジタル庁が運営する Jグランツ の公開APIです。仕様は JグランツAPIドキュメント にあります。利用にあたっては JGrants Web-API 利用規約 に従ってください。API利用概要では呼び出し上限は10回/1秒とされています。
返るのは補助金制度の情報のみで、申請した会社や採択された会社の情報は含まれません。採択実績は gBizINFO 側の情報です。
JGrantsに登録された公募だけが対象です。受付開始前の公募も
acceptance=0で引けますが、各省庁の概算要求や予算案の段階にある事業は載りません。日時はAPIの返却値(UTC)のまま返します。日本時間への変換は利用側で行ってください。
キーワード検索の絞り込みは粗く、無関係な公募が混ざることがあります。タイトル・対象地域・業種で選別して使ってください。
デジタル庁公式のMCPサーバー(digital-go-jp/jgrants-mcp-server)は技術検証目的のサンプルコードと位置づけられているため、本リポジトリは公開APIを直接呼ぶ独立実装にしています。エンドポイントとパラメータの確認には公式サンプルのコードを参照しました。
開発
uv sync --locked
uv run ruff check .
uv run ty check
uv run pytest
uv buildCIのテストはオフライン(HTTPモック)で動きます。上流APIの契約確認は、実APIへの小さな読み取りサンプルで別途行います。
Available Tools
2 toolsget_subsidy_detailARead-onlyIdempotent
補助金1件の詳細を取得する。
補助率、利用目的、対象業種、公募要領の本文(HTMLをプレーンテキスト化
したもの)、募集の回(workflow)ごとの対象地域と受付期間、事業終了
期限が返る。添付ファイル(公募要領・申請様式)は本体(Base64)を
省略し、ファイル名などのメタデータだけを返す。日時はUTC。
Args:
subsidy_id: search_subsidies が返した補助金ID(18文字以下)。
version: 詳細APIの版。v2 は募集の回ごとに地域と期間を持つ形で、
既定はこちら。v1 は地域と期間が公募直下にある旧形式で、
workflow 1件に正規化して返す。
Inputs: subsidy_id (required), version. Returns: object
search_subsidiesARead-onlyIdempotent
JGrantsに登録された補助金をキーワードで検索する。
返るのは制度の情報(補助金名・対象地域・従業員数の条件・補助上限額・
受付期間)で、申請者や採択企業の情報は含まれない。キーワード検索の
絞り込みは粗く、無関係な公募が混ざることがある。受付期間の日時は
UTC(APIの返却値そのまま)。
Args:
keyword: 検索キーワード(2文字以上255文字以下、必須)。
sort: 並べ替え項目。created_date / acceptance_start_datetime /
acceptance_end_datetime。
order: ASC(昇順)または DESC(降順)。
acceptance: 1 は受付中のみ、0 は受付前・終了分も含む全て。
industry: 業種での絞り込み(APIの定義値)。
use_purpose: 利用目的での絞り込み(APIの定義値)。
target_number_of_employees: 従業員数の条件(APIの定義値)。
target_area_search: 補助対象地域での絞り込み(例: 東京都)。
Inputs: keyword (required), sort, order, industry, +4 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
search_subsidies handles discovery, while get_subsidy_detail retrieves a specific subsidy by ID. Their purposes are clearly distinct, and the version parameter applies only to the detail operation.
Both tools follow the same snake_case verb_noun pattern: search_subsidies and get_subsidy_detail. There is no mixing of naming conventions.
The two tools are non-redundant and directly cover search plus detail, but the surface is thinner than the typical 3-15 tool range. For a narrow read-only API wrapper this may be adequate, but it leaves little room for auxiliary operations.
The core read-only workflow of searching subsidies and then retrieving details is well covered, including rich filters and detailed result fields. Minor gaps remain: agents cannot discover valid filter code values, cannot browse without a keyword, and pagination is not mentioned.
Maintenance
Related MCP Connectors
Search Japanese subsidies and public company data using J-Grants, gBizINFO, and EDINET.
Search verified-open US grants (federal, state, foundation). Read-only MCP for AI agents.
Search US grants + federal contracts (Grants.gov + SAM.gov) from any LLM.
Search 77k public-sector open data APIs across 10 countries. Read-only, no API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables searching and retrieving details of over 500,000 Spanish government grants and subsidies from the official BDNS database, without requiring an API key.-
- AlicenseAqualityDmaintenanceReal-time search of Japanese government subsidies and grants (official jGrants data): deadlines, amounts, eligibility, filterable by prefecture.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search Japanese government subsidies and grants, including archived closed calls and recurring application periods based on historical data.12 npm1MIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server that searches Japanese government grant information and retrieves subsidy details and attached file content via the J-Grants public API.MIT