Jグランツ Subsidy Search MCP — torchi PoC

A read-only remote MCP server that lets you use the Digital Agency's Jグランツ public API from MCP clients such as Notion.

Based on the Digital Agency's public sample digital-go-jp/jgrants-mcp-server, it adds authentication, health checks, container configuration, and output volume control for always-on operation on Sliplane.

Provided Tools

• ping — connection check

• search_subsidies — search by keyword, region, industry, number of employees, and purpose of use

• get_subsidy_overview — aggregate by application deadline period and maximum grant amount

• get_subsidy_detail — get details and a list of attached documents

• get_file_content — convert only the selected attached document to Markdown

Search results include the official Jグランツ URL and attribution. The retrieved information is for reference only; please check the official page for the latest information before applying.

Related MCP server: koko-call-mcp

Remote Configuration

Notion
  -> HTTPS + Bearer token
  -> Caddy gateway（公開）
  -> FastMCP server（Sliplane内部のみ）
  -> Jグランツ公開API

• /health is exposed without authentication for monitoring.

• /mcp validates the same Bearer token on both the Gateway and the MCP server itself.

• The token is stored only in Sliplane's Secret environment variables and is never placed in GitHub or logs.

• Attached documents are stored in the MCP server's temporary storage area, and only the content of the required files is returned.

Local Development

Requires Python 3.10 or later and uv.

uv sync
uv run pytest
JGRANTS_REQUIRE_AUTH=0 uv run python -m jgrants_mcp_server

The Docker configuration with authentication is as follows:

cp .env.example .env
# .envのMCP_AUTH_TOKENを32文字以上のランダム値へ変更
docker compose up --build
curl http://localhost:8080/health
curl -i http://localhost:8080/mcp

An unauthenticated request to /mcp returns HTTP 401.

Sliplane Configuration

Create two services from the same GitHub repository.

jgrants-mcp

• Dockerfile: Dockerfile

• Public: Off

• Healthcheck: /health

• Environment variables:

  • JGRANTS_HOST=0.0.0.0

  • JGRANTS_PATH=/mcp

  • JGRANTS_REQUIRE_AUTH=1

  • MCP_AUTH_TOKEN=<secret>

  • PORT=8000

jgrants-mcp-gateway

• Dockerfile: gateway/Dockerfile

• Public: On

• Healthcheck: /health

• Environment variables:

  • MCP_AUTH_TOKEN=<same secret>

  • UPSTREAM_URL=http://jgrants-mcp.internal:8000

Configure automatic deployment for pushes to main. In Notion, register the Gateway's public URL with /mcp appended, along with the Bearer token.

License and Attribution

The code is MIT-licensed. Use of the Jグランツ API must comply with the Jグランツ API Terms of Use. When publishing or repurposing, please clearly credit Jグランツ as the source.