Search 1B+ economic time series across 93 providers (ECB, BLS, IMF, OECD, WB, Eurostat, FRED) via @pipeworx/mcp-dbnomics — 5 tools, no auth

@pipeworx/mcp-dbnomics v latest — DBnomics Meta-Aggregator MCP

Package: @pipeworx/mcp-dbnomics (npm) Architecture: Library-style export {tools, callTool} — NOT a stdio server. TypeScript source only (src/index.ts, no dist). Requires node --experimental-strip-types --no-warnings. Copy source outside node_modules first (ESM guard). API: DBnomics (https://db.nomics.world) — meta-aggregator over 93 statistics providers, ~1 billion time series, free, no auth. Tools: 5

Tool inventory

Critical gotchas

1. ⚠️ `search` returns DATASETS, not individual series — each result has provider_code, code (dataset), name, nb_matching_series, nb_series. To get actual data points, follow up with get_series.
2. ⚠️ `find_series` dimensions filter is BROKEN — passing dimensions: { FREQ: 'A', CURRENCY: 'TRY' } always returns 0 results regardless of format (JSON string, bracket notation, flat params — all tested against raw API). Use get_series with the full dot-separated series code instead.
3. ⚠️ `list_datasets` returns `category_tree`, NOT a flat list — response has nested categories with children, e.g. ECB has 17 categories containing 111 datasets. Access via r.category_tree[].children[].code.
4. Provider codes are auto-uppercased — 'ecb' works (converted to 'ECB').
5. `observations: false` correctly omits period/value arrays (metadata only) — useful for fast lookups.
6. Series codes are dot-separated dimensions — e.g. ECB/EXR: A.USD.EUR.SP00.A = Annual.USDollar.Euro.Spot.Average. You need the dataset's dimensions_codes_order to decode.
7. Pagination works via offset + limit (0-based, max 1000).
8. 404 thrown for nonexistent providers/series — caught cleanly as error.

Verified execution trace (18 calls, 100% success)

list_providers:

callTool('list_providers', {})
→ { providers: { docs: [...93 providers...] } }
// Sample: ACOSS, AFDB, AIH, AMECO, Apple, AQICN, BCB, BCEAO, BDF, BEA, BIS, BLS,
//         BOJ, BOK, CBS, DB, DESTATIS, ECB, Eurostat, FRED, ILO, IMF, INSEE,
//         ISTAT, OECD, ONS, SCB, SNB, WB, WTO, ... (93 total)
// 2669ms (first call)

search (returns datasets):

// Inflation data
callTool('search', { query: 'inflation rate', limit: 5 })
→ { results: { num_found: 41, docs: [{ provider_code: 'ECB', code: 'CSEC', name: '...', nb_series: ... }, ...] } } // 858ms

// GDP
callTool('search', { query: 'GDP growth', limit: 3 })
→ { results: { num_found: 132, docs: [{ provider_code: 'ISTAT', code: '3_156', name: 'Gross domestic product...' }, { provider_code: 'Eurostat', code: 'namq_10_gdp', nb_series: 66667 }, ...] } } // 1237ms

// Unemployment
callTool('search', { query: 'unemployment rate', limit: 3 })
→ { results: { num_found: 568, docs: [{ provider_code: 'ILO', code: 'UNE_DEAP_SEX_AGE_EDU_RT' }, ...] } } // 1452ms

// Turkish CPI
callTool('search', { query: 'Turkey consumer price index', limit: 3 })
→ { results: { num_found: 12, docs: [{ provider_code: 'IMF', code: 'PGI' }, ...] } } // 1389ms

// ECB interest rates
callTool('search', { query: 'ECB key interest rate', limit: 3 })
→ { results: { docs: [{ provider_code: 'ECB', code: 'RIR' }, { provider_code: 'ECB', code: 'FM' }, ...] } } // 508ms

// Pagination
callTool('search', { query: 'GDP', limit: 3, offset: 10 })
→ { results: { n