Skip to content
MCP server

Ilostat MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.4.0
Listing updated
4 days ago

About Ilostat MCP Server

Ilostat MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

claude mcp add --transport http ilostat-mcp-server https://ilostat.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://ilostat.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ilostat-mcp-server": {
      "url": "https://ilostat.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ilostat-mcp-server": {
      "type": "http",
      "url": "https://ilostat.caseyjhand.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "ilostat-mcp-server": {
      "serverUrl": "https://ilostat.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ilostat-mcp-server": {
      "type": "http",
      "url": "https://ilostat.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • ILOSTAT_CATALOG_REFRESH_HOURSHours between checks of the ILOSTAT tables of contents (1–168).
  • ILOSTAT_MAX_ROWSCeiling on the rows one query reads or stages (1,000–1,000,000); a filtered result past it is paged but not staged, and a page reaching past it is refused.
  • ILOSTAT_PREVIEW_CHARSStaging trigger in serialized characters: a query or comparison whose first page finds its result past it is staged as a dataframe; their pages are bounded by limit, not by it. A dataframe SQL result returns only the leading rows that fit.
  • ILOSTAT_CACHE_TTL_SECONDSSeconds a small upstream data response stays cached (0 disables the cache).
  • ILOSTAT_DATASET_TTL_SECONDSPer-table TTL for staged dataframes, in seconds (at least 60).
  • ILOSTAT_DATAFRAME_DROP_ENABLEDSet to true to expose ilostat_dataframe_drop; staged dataframes otherwise expire on their TTL.
  • CANVAS_PROVIDER_TYPEDataCanvas engine for staged dataframes: duckdb (default) or none to turn dataframes off.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • ILOSTAT_CATALOG_REFRESH_HOURSHours between checks of the ILOSTAT tables of contents (1–168).
  • ILOSTAT_MAX_ROWSCeiling on the rows one query reads or stages (1,000–1,000,000); a filtered result past it is paged but not staged, and a page reaching past it is refused.
  • ILOSTAT_PREVIEW_CHARSStaging trigger in serialized characters: a query or comparison whose first page finds its result past it is staged as a dataframe; their pages are bounded by limit, not by it. A dataframe SQL result returns only the leading rows that fit.
  • ILOSTAT_CACHE_TTL_SECONDSSeconds a small upstream data response stays cached (0 disables the cache).
  • ILOSTAT_DATASET_TTL_SECONDSPer-table TTL for staged dataframes, in seconds (at least 60).
  • ILOSTAT_DATAFRAME_DROP_ENABLEDSet to true to expose ilostat_dataframe_drop; staged dataframes otherwise expire on their TTL.
  • CANVAS_PROVIDER_TYPEDataCanvas engine for staged dataframes: duckdb (default) or none to turn dataframes off.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Ilostat MCP Server FAQ

Is Ilostat MCP Server free?

Yes. Ilostat MCP Server is open source, so you can use and self-host it for free.

How do I add Ilostat MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http ilostat-mcp-server https://ilostat.caseyjhand.com/mcp