Finance Calendar
Economic release dates, central bank decisions and holidays for AI assistants
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://www.financecalendar.com/wp-json/fc-mcp/v1/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"financecalendar": {
"url": "https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp"
}
}
}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.
Alternatives to Finance Calendar

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 7 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
- 5 tools
- Remote
- Open source
- Legal and government