scb-mcp

MCP server that wraps Statistics Sweden's PxWebApi so LLMs can query SCB's statistical database directly.

Install

git clone https://github.com/IsakRizell/scb-mcp.git
cd scb-mcp
pip install -e .

Requires Python 3.11+.

Related MCP server: statfin-fi

Register with Claude Code

claude mcp add scb --scope user -- scb-mcp --transport stdio

Tools then show up as mcp__scb__* in every session.

Tools

• navigate(path) — list children of a catalog node. path="" for root.

• get_table_metadata(table_id) — variables, value codes, time range for a table.

• query_table(table_id, query) — single PxWebApi query.

• query_table_chunked(table_id, query, chunk_by, chunk_size) — auto-splits queries over SCB's ~150k cell limit and merges results.

• search_tables(keyword, start_path, max_results, max_depth) — BFS the catalog tree for tables matching a keyword.

Transports

• stdio (default for MCP clients)

• http — Streamable HTTP at /mcp + legacy SSE at /sse + /messages

scb-mcp --transport http --port 8765

Rate limit

SCB allows 30 requests per 10 seconds. The client throttles to 28/10s to stay safe.

License

MIT