Skip to main content
Glama
jgrants-mcp-poc

jgrants-mcp-poc

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Japan's Jグランツ grant application system, enabling LLMs to search and retrieve subsidy information via natural language.
      51
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Read-only MCP server for searching Japanese government procurement bid notices (官公需) from the SME Agency's KKJ portal. Includes AI ranking, PDF requirement extraction, and CSV/calendar export.
      49 npm
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for searching Japanese government procurement notices via the Kanpou API. Enables LLMs to search by date, keyword, or detailed criteria.
      3
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides access to Japan's central and municipal subsidies, covering over 20,000 municipal grants not exposed by official APIs, with tools for search, comparison, citation verification, and practitioner referrals.
      13
      MIT