Ilostat MCP Server

by cyanheadsio.github.cyanheads/ilostat-mcp-serverv0.1.2

Search ILOSTAT labour indicators, query and compare series, build country profiles, run SQL.

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Ilostat MCP server

claude mcp add ilostat -- npx -y @cyanheads/ilostat-mcp-server

{
  "mcpServers": {
    "ilostat": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/ilostat-mcp-server"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ilostat": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/ilostat-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ilostat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/ilostat-mcp-server"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ilostat": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/ilostat-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ILOSTAT_CATALOG_REFRESH_HOURS	—	—	Hours between checks of the ILOSTAT tables of contents (1–168).
ILOSTAT_MAX_ROWS	—	—	Ceiling on the rows one query may return or stage (1,000–1,000,000).
ILOSTAT_PREVIEW_CHARS	—	—	Inline preview budget in serialized characters; a larger result is staged as a dataframe.
ILOSTAT_CACHE_TTL_SECONDS	—	—	Seconds a small upstream data response stays cached (0 disables the cache).
ILOSTAT_DATASET_TTL_SECONDS	—	—	Per-table TTL for staged dataframes, in seconds (at least 60).
ILOSTAT_DATAFRAME_DROP_ENABLED	—	—	Set to true to expose ilostat_dataframe_drop; staged dataframes otherwise expire on their TTL.
CANVAS_PROVIDER_TYPE	—	—	DataCanvas engine for staged dataframes: duckdb (default) or none to turn dataframes off.
MCP_LOG_LEVEL	—	—	Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPE	—	—	Selects the HTTP transport.
MCP_HTTP_HOST	—	—	The hostname for the HTTP server.
MCP_HTTP_PORT	—	—	The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATH	—	—	The endpoint path for the MCP server.
MCP_AUTH_MODE	—	—	Authentication mode to use: 'none', 'jwt', or 'oauth'.