Skip to content
MCP server

Finance Calendar

Economic release dates, central bank decisions and holidays for AI assistants

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Remotely
Version
1.1.0
Listing updated
today

About Finance Calendar

Finance Calendar is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

The Finance Calendar MCP server gives Claude, ChatGPT, Cursor and other MCP clients read-only access to recorded economic release schedules, central bank decision dates and exchange holidays. Each answer can carry the publisher source, reference period and release stage where the data records them.

There are two ways to connect. The hosted endpoint uses OAuth account linking or a private API-key header and exposes 14 tools, while the local stdio server from the project's GitHub repository adds 19 tools, including archive lookups, and reads an API key from the process environment. Both draw on the same Finance Calendar API, so data calls count against the account's daily and monthly allowance.

The README says live data requires a paid plan or an applicable retained grant, and that the public calendar can be browsed for free. Free-tier schedules and a small public US CPI and FOMC sample are also described. It suits analysts, traders and developers who want an assistant to check release timing and consensus against source links.

Install

Run in a terminal

claude mcp add --transport http financecalendar https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp

Add to Settings → Connectors → Add custom connector

https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "financecalendar": {
      "url": "https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "financecalendar": {
      "type": "http",
      "url": "https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "financecalendar": {
      "serverUrl": "https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "financecalendar": {
      "type": "http",
      "url": "https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

next_event
Next recorded occurrence of a series or central bank decision.
calendar
Filtered calendar window of releases, decisions and holidays.
today
Today's recorded releases and market information.
week
This or next week's Monday-to-Sunday events.
series_list
Discover series codes, aliases and next dates.
series_detail
Metadata, upcoming releases and history for one series.
history
Past release records with prior, actual and consensus fields.
market_holidays
Exchange holidays and early closes.
market_status
Current exchange session status.
changes
Recorded additions, updates and removals with cursor paging.
countries
Recorded country coverage and counts.
feed_status
Snapshot age, source health and numerical coverage.

What it does

Hosted read-only connector
A Streamable HTTP endpoint with OAuth sign-in or an API-key header, limited to calendar read permissions.
Release and decision lookup
Find the next occurrence of a series such as US CPI, FOMC or UK CPI, with time zone conversion.
Market holiday and session checks
Query exchange holidays, early closes and whether a market is currently open.
Source and timing evidence
Results can include the publisher source, reference period, release stage and time precision.
Local stdio option
A Node package runs locally with an FC_API_KEY environment variable and adds archive tools.

Good for

  • Check the date and time of the next US CPI or FOMC decision inside a chat
  • Build a weekly briefing of high-impact US and UK releases with source links
  • Confirm whether a stock exchange is closed on a given day before planning trades
  • Compare published economic results with recorded consensus figures

Pricing

Freemium, from $9.99 a month

Public calendar free; Starter from US$9.99/year; Build US$9.99/month; Scale US$29/month. Hosted MCP needs a paid plan.

Prices change. Check financecalendar.com before you buy.

Finance Calendar FAQ

Is the hosted server free to use?

The README says hosted MCP access requires a paid plan or an applicable retained grant, while the public economic calendar can be browsed free. Free Developer access covers schedule-only JSON through the REST API.

How do I connect Claude or ChatGPT?

Add the hosted server URL as a custom connector, choose OAuth account linking, sign in to Finance Calendar and approve the read-only permission.

Does connecting an assistant change my subscription?

According to the setup guide, approving a connection does not create a subscription, change the plan or grant billing permissions, and it can be revoked in connected-assistant settings.

Can the assistant place trades or change my account?

The server is described as read-only, with the calendar:read permission for economic-calendar data reads.

Is Finance Calendar free?

Finance Calendar has a free plan, with paid plans for more usage or features. Paid plans start at $9.99 a month.

How do I add Finance Calendar to Claude Code?

Run this command in your terminal: claude mcp add --transport http financecalendar https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp

What are the best alternatives to Finance Calendar?

The closest alternatives to Finance Calendar are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Finance Calendar

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 7 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    • 5 tools
    • Remote
    • Open source
    • Legal and government