Nbb MCP server

mcp-nbb

<!-- mcp-name: io.github.lacausecrypto/mcp-nbb -->

MCP server for the National Bank of Belgium SDMX statistical API.

Exposes the 221 NBB dataflows (194 BE2 + 27 IMF/SDDS) as 6 LLM-friendly tools and 3 browsable resources, with a bundled enriched catalogue so the LLM can discover, describe, and query dataflows without redundant API calls.

• Upstream: https://nsidisseminate-stat.nbb.be/rest (NSI Web Service v8)
• Transport: stdio (standard MCP)
• Python: 3.11+
• Platforms: Linux, macOS, Windows
• 221 dataflows classified into 14 categories — see DATAFLOWS_CATALOG.md

Install

From PyPI (recommended)

# With uv (runs without installing globally)
uvx mcp-nbb

# Or install into a regular venv
pip install mcp-nbb

From source

git clone https://github.com/lacausecrypto/mcp-nbb.git
cd mcp-nbb
pip install -e .

The package ships with the full enriched catalogue (~9 MB under src/nbb_mcp/data/catalog/). No build step is required for regular use.

Claude Desktop configuration

Edit ~/Library/Application Support/Claude/claudedesktopconfig.json on macOS, %APPDATA%\Claude\claudedesktopconfig.json on Windows, or the equivalent on Linux.

Using uvx (recommended once published to PyPI)

{
  "mcpServers": {
    "nbb": {
      "command": "uvx",
      "args": ["mcp-nbb"]
    }
  }
}

From a local editable install

macOS / Linux:

{
  "mcpServers": {
    "nbb": {
      "command": "/Users/you/projects/mcp-nbb/.venv/bin/mcp-nbb"
    }
  }
}

Windows:

{
  "mcpServers": {
    "nbb": {
      "command": "C:\\Users\\you\\projects\\mcp-nbb\\.venv\\Scripts\\mcp-nbb.exe"
    }
  }
}

Restart Claude Desktop — the 6 nbb_* tools appear in the MCP panel.

Tools

nbb_quick topics

Shortened. The full README is on GitHub.