# scb-mcp

MCP server that wraps [Statistics Sweden's PxWebApi](https://www.scb.se/en/services/open-data-api/api-for-the-statistical-database/) so LLMs can query SCB's statistical database directly.

## Install

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

Requires Python 3.11+.

## Register with Claude Code

```bash
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`

```bash
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