Macro Index
API & MCP →

API & MCP

Free and open: no key, no sign-up. Every response carries meta.dataset_version, so you can cite exactly what you read. Facts and calendars only: no forecasts, odds or opinions.

MCP

Streamable HTTP, stateless: https://macroindex.org/mcp. Tools: upcoming_decisions, bank_status, upcoming_auctions, check_question, resolution_sources, dataset_health and submit_correction. check_question refuses a decision or an auction that has not been observed.

claude mcp add --transport http macroindex https://macroindex.org/mcp

In Claude (web, desktop, mobile): Settings → Connectors → Add custom connector, name it Macro Index and paste https://macroindex.org/mcp. No sign-in is needed. Then ask, for example: "When does the ECB next decide on rates?" or "What did the Bank of Japan decide at its last meeting?"

Other clients (Cursor, VS Code, ChatGPT and others that take a remote MCP server): add https://macroindex.org/mcp as a Streamable HTTP server. A static server card is at /.well-known/mcp/server-card.json.

REST

Plain JSON with CORS. Every response is {data, meta}.

EndpointReturns
/v1/upcomingMeetings in a window (?from=YYYY-MM-DD&to=YYYY-MM-DD, default today + 60 days): date, announceAt (UTC), dateStatus, rateBefore, calendarSource, settleSource, observed
/v1/bank/ecbOne bank: rate in force, last decision, next meeting, history facts, freshness
/v1/bank/<id>/decision/<YYYY-MM-DD>One observed decision: rate before and after, the statement and, where read, the bank's reasons
/v1/releasesInflation releases in a window (Eurostat flash HICP, Destatis CPI)
/v1/auctions · /v1/auctions/history?issuer=de-finanzagentur&tenor=10YGovernment bond auctions (?from&to&issuer&tenor) and results by tenor
/v1/banks · /v1/health · /v1/correctionsBank list, freshness and warnings, the corrections log

Decision pages

Each observed decision with a written account has its own page: the rate before and after, the statement, and the reasons the bank gave, paraphrased and attributed. Cite it for a question about one decision; the statement it links is the authority.

Corrections

Report a mistake with the URL that proves it: POST /v1/corrections with JSON {"claim": "...", "evidence": "https://...", "bank": "optional-id"}, the MCP tool submit_correction, or the form. Every report and its outcome is public.

Licence and attribution

Data is CC BY 4.0, © MC² Ventures. Credit Macro Index and link to the site (or the bank's page) where you show or republish it.

Machine-readable descriptions

/openapi.json · /llms.txt · /data/dataset.json