jgrants-mCP

You can access up-to-date Japanese subsidy information through a dedicated MCP server that wraps the public jGrants API. This server exposes three practical tools that return structured data, making it easy for an LLM to search subsidies, view details, and download lightweight attachments without handling raw API responses.

How to use

Connect with an MCP client and use the three available tools to work with subsidies. You can search for subsidies by keyword, retrieve detailed information for a specific subsidy, and download attachment files such as application guidelines or grant outlines. All responses are returned in a structuredContent field to maximize processing efficiency by your LLM.

How to install

Prerequisites you need before installing this MCP server:

Install the MCP server globally with npm, or run it directly via npx. You can also develop locally by cloning the repository and building from source.

# Global installation
npm install -g jgrants-mcp

# Run directly with npx
npx jgrants-mcp

# Local development
git clone https://github.com/tachibanayu24/jgrants-mcp.git
cd jgrants-mcp
npm install
npm run build

Additional content

Configuration and usage notes summarize how you deploy and run the server with MCP clients. The server provides a straightforward, local runtime via a standard command. You will typically start it using npx to avoid global installs during development, and you can keep a local development flow using the repository’s build steps.

Important items you may encounter include how the tools return structured data, how attachments are represented (with metadata and indices for download), and how to perform each operation from an MCP client. The server does not require an API key to access the public jGrants API.

# Example MCP client config (stdio)
{
  "type": "stdio",
  "name": "jgrants",
  "command": "npx",
  "args": ["jgrants-mcp"]
}

Available tools

list_subsidies

Fetches a list of subsidies currently open for application based on a keyword search. Returns structured data including id, name, title, eligible regions, and subsidy limits.

get_subsidy_detail

Retrieves detailed information for a specific subsidy by its id. Provides structured metadata for attachments, including count, presence, and file metadata (index, name, size). Base64 data is not included.

download_attachment

Downloads a specific attachment for a subsidy. Returns Base64-encoded file data along with file name, size, and encoding information. Requires subsidy_id, category, and index.