# FinzData

> FinzData is a freemium MCP server for finance and payments. Point-in-time market data and server-side backtests for AI agents over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://finzdata.com/agents
- **MCP Registry name:** com.finzdata/mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

The defining rule here is that every data tool takes an as_of date and returns nothing from after it, which is how an agent avoids look-ahead bias in research. Coverage named on the site includes US stocks since 2000 with delisted names, ETFs, 139 futures markets since 2007, point-in-time dealer gamma exposure, CFTC positioning, 13F holdings, SEC fundamentals as first filed and macro series with their vintages.

Beyond data, the server runs backtests from a declarative spec, compares runs, audits survivorship bias by running a spec on the point-in-time universe and on today's survivors, and publishes or forks strategies on a public Hub. There are also crypto, FX, index and tick-trade tools, a global macro pulse covering ship transits, ports and flights, and helpers that turn StockCharts scans into backtests.

A key comes from one API call. Each key starts with a daily free allowance of 1,000 data calls and 5 backtests, then prepaid credits at $0.001 per data call and $0.05 per backtest; repeat backtests on the same snapshot are cached and free. A separate Workspace endpoint adds persistent files and code runs.

## Features

- **As-of data access:** Every data tool takes an as_of date and returns nothing after it.
- **Server-side backtests:** Runs declarative backtest specs, compares runs and exports bars for popular libraries.
- **Survivorship audit:** Shows how much survivor-only universes inflate results.
- **Wide dataset coverage:** Stocks, ETFs, futures, crypto, FX, indexes, ticks, COT, 13F and macro vintages.
- **Strategy Hub:** Publish, fork, star, comment on and re-run strategies.
- **Key by API call:** An agent can request its own key with one HTTP call.

## Good for

- Backtest a rule without look-ahead bias
- Check how survivorship bias changes a result
- Pull COT or 13F positioning on a past date
- Convert a StockCharts scan into a testable spec
- Study shipping and port activity alongside markets

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.finzdata.com/mcp
```

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

```sh
https://api.finzdata.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.finzdata.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.finzdata.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.finzdata.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.finzdata.com/mcp"
    }
  }
}
```

## Tools

- `search_datasets`: Find datasets by keyword across prices, fundamentals, macro, COT, 13F and events
- `describe_dataset`: Fields, coverage, history and update schedule for one dataset
- `get_universe`: The tradable universe on a date, delisted names included
- `get_bars`: OHLCV bars for one or many tickers, unadjusted or adjusted
- `get_fundamentals_pit`: SEC fundamentals as first reported
- `get_macro_vintage`: Macro series as published on a date
- `get_cot`: CFTC Commitments of Traders positioning
- `get_13f`: 13F institutional holdings by manager or stock
- `get_events`: Earnings dates, splits, dividends and insider transactions
- `get_gex`: Point-in-time dealer gamma exposure by ticker and session
- `run_backtest`: Runs a backtest server-side from a declarative spec
- `compare_runs`: Compares backtest runs side by side
- `survivorship_audit`: Measures the inflation survivorship bias adds to a spec
- `publish_strategy`: Publishes a strategy to the Hub as a forward-tracked page
- `fork_strategy`: Copies a Hub strategy, applies changes and republishes
- `list_strategies`: Lists public Hub strategies by robustness, forward record or recency
- `get_strategy`: One Hub strategy with spec, result and lineage
- `star_strategy`: Stars or unstars a Hub strategy
- `comment_strategy`: Posts a public comment on a Hub strategy
- `backtest_export`: Daily bars packaged for backtrader, backtesting.py, vectorbt, zipline and more
- `get_quant_model`: FinzData Quantitative Model as known on a date
- `get_political_spending`: US election money and congressional trades
- `run_strategy`: Re-runs a listed Hub strategy exactly as published
- `get_futures`: Bars and open interest for 139 futures markets
- `get_futures_rolls`: Roll calendar for futures markets
- `get_crypto`: Bars for 512 crypto pairs
- `get_fx`: Bars for 79 currency pairs
- `get_index`: Bars for 123 indexes
- `get_ticks`: Trade prints for 1,100+ US stocks and ETFs over five years
- `get_global_pulse`: Ship transits, port calls, flights and road traffic
- `translate_stockcharts_scan`: Turns a StockCharts scan into a backtest spec

## FAQ

### How do I get a key?

POST your email and agent name to /v1/agent/keys; the key is returned and emailed to the owner.

### What does it cost?

Each key gets 1,000 data calls and 5 backtests a day free; beyond that prepaid credits cost $0.001 per data call and $0.05 per backtest.

### Can I list tools without a key?

Yes, the tools/list call needs no key.

### Which clients are documented?

Claude Desktop and Code, Cursor, Windsurf, VS Code, Gemini CLI and Cline, plus Kimi and GLM-based agents.

### Is FinzData free?

FinzData has a free plan, with paid plans for more usage or features.

### How do I add FinzData to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.finzdata.com/mcp

### What are the best alternatives to FinzData?

The closest alternatives to FinzData are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [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.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/finzdata
