e-Stat

You use this MCP server to expose e-Stat API capabilities so a generated AI can request statistical data, metadata, tables, and surveys in a simplified JSON format. It acts as a bridge that translates AI requests into e-Stat API calls and returns streamlined responses you can easily consume in conversations or tooling.

How to use

You connect an MCP client to this server to fetch statistics data, metadata, survey lists, and tables from e-Stat. Start the server, configure your client with the correct API key, and issue the built‑in tool requests. The AI can ask for a specific stats data set, a metadata item, or a list of available tables or surveys, and you’ll receive a simplified JSON response suitable for AI planning and decision making.

How to install

Prerequisites you need before building and running the MCP server:

• Java 17 or newer
• Gradle (or use the Gradle wrapper)

1. Clone or copy the project files to your development environment.

2. Build the MCP server package.

./gradlew clean build -x test

Additional setup and running notes

Obtain your e-Stat application ID following the provided steps for registering with e-Stat. This value is used to authorize API requests from the MCP server.

Configure your client environment to supply the API key and a preferred response size. The following environment variables are used by the MCP server:

• ESTAT_API_KEY: Your e-Stat application ID or API key.

• RESPONSE_SIZE: The maximum number of records to fetch per API call. The e-Stat default is 100,000.

Configuring MCP server connections

You can run the MCP server locally as a Java JAR or via Docker. Two explicit configurations are provided: one for a built JAR and one for a Docker container.

Configuration examples

{
  "mcpServers": {
    "estatMCP": {
      "command": "java",
      "args": [
        "-jar",
        "build/libs/<your-jar-name>.jar"
      ],
      "env": {
        "ESTAT_API_KEY": "<アプリケーションID>",
        "RESPONSE_SIZE": "100"
      }
    }
  }
}

Notes on Docker and environment variables

If you prefer Docker, use this configuration to run the MCP server container and pass the required environment variables.

{
  "mcpServers": {
    "estatMCP": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESTAT_API_KEY",
        "-e",
        "RESPONSE_SIZE",
        "ichiro21/estat-mcp"
      ],
      "env": {
        "ESTAT_API_KEY": "<アプリケーションID>",
        "RESPONSE_SIZE": "100"
      }
    }
  }
}

Available tools

get_tables

Fetches the list of statistical tables available and returns a simplified JSON representation.

get_surveys

Retrieves the list of surveys within a given statistics table.

get_metadata

Obtains metadata for a specified statistics table ID (statsDataId).

get_data

Fetches actual statistical data for a specified statistics table ID (statsDataId).