lacausecrypto avatar

Mcp Nbb

lacausecrypto/mcp-nbb

Connects Claude to the National Bank of Belgium's SDMX statistical API, exposing all 221 dataflows (exchange rates, inflation, GDP, employment, government finances) through six LLM-friendly tools. Ships with a 9MB enriched catalog so Claude can search and describe datasets without hitting the API. The query tool handles raw SDMX keys or friendly filters like `{"FREQ":"D","EXR_CURRENCY":"USD"}`, while quick shortcuts cover 18 common queries (policy rates, HICP inflation, unemployment). The compare tool aligns multiple series on a common time index with automatic frequency downsampling. Includes persistent disk caching and proper WAF headers for the NBB endpoint. Useful when you need Belgian or IMF/SDDS economic data in conversational workflows without manually navigating the data explorer.

GitHub stars
3
tools
6
transport
STDIO
env vars
3
last updated
Apr 12, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

nbb_searchFuzzy search over the 221 local fiches (en/fr/nl/de).

Fuzzy search over the 221 local fiches (en/fr/nl/de).

No parameter schema in public metadata yet.

nbb_describeFull enriched fiche — dimensions, codelists, key template, common queries. force_refresh=True revalidates live.

Full enriched fiche — dimensions, codelists, key template, common queries. force_refresh=True revalidates live.

No parameter schema in public metadata yet.

nbb_queryGeneric data fetch. Either key (raw SDMX) or filters (e.g. {"FREQ":"D","EXR_CURRENCY":"USD"}).

Generic data fetch. Either key (raw SDMX) or filters (e.g. {"FREQ":"D","EXR_CURRENCY":"USD"}).

No parameter schema in public metadata yet.

nbb_quickTopic-based shortcut for 18 common queries.

Topic-based shortcut for 18 common queries.

No parameter schema in public metadata yet.

nbb_compareAlign 2-5 series on a common time index, downsampling finer frequencies via closing aggregation.

Align 2-5 series on a common time index, downsampling finer frequencies via closing aggregation.

No parameter schema in public metadata yet.

nbb_statusDiagnostic snapshot: catalog, cache, API config.

Diagnostic snapshot: catalog, cache, API config.

No parameter schema in public metadata yet.

Sponsors

Configuration

NBB_LOG_LEVELdefault: INFO

Log level: DEBUG, INFO, WARNING, ERROR

NBB_LOG_FORMATdefault: json

Log format: 'json' or 'console'

NBB_HTTP_CACHE_ENABLEDdefault: true

Enable the persistent HTTP disk cache

Readme

mcp-nbb

CI PyPI version Python versions License: MIT MCP compatible

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.


View the full README on GitHub

Details

Repository
github.com/lacausecrypto/mcp-nbb
Package
mcp-nbb
Transport
STDIO
Registry
MCP registry, active

More from lacausecrypto