
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 toolsPublic 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: INFOLog level: DEBUG, INFO, WARNING, ERROR
NBB_LOG_FORMATdefault: jsonLog format: 'json' or 'console'
NBB_HTTP_CACHE_ENABLEDdefault: trueEnable the persistent HTTP disk cache
Readme
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.
Details
- Repository
- github.com/lacausecrypto/mcp-nbb
- Package
mcp-nbb- Transport
- STDIO
- Registry
- MCP registry, active