# Finance Calendar

> Finance Calendar is a freemium MCP server for finance and payments. Economic release dates, central bank decisions and holidays for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9.99 a month
- **Platforms:** API, CLI, Web
- **Website:** https://www.financecalendar.com/api/mcp/
- **Repository:** https://github.com/awarenessdays/financecalendar-api
- **MCP Registry name:** io.github.awarenessdays/financecalendar
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.financecalendar.com/wp-json/fc-mcp/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/finance-calendar
