finzdata-mcp

Server Details

US market data, point-in-time fundamentals, macro vintages, COT, 13F and backtests for AI agents.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Last Tested: 2026-10-13 15:01
Transport: Streamable HTTP · MCP 2025-11-25
URL

TDQS

Score is being calculated.

Available Tools

11 tools

compare_runsCompare runs

Read-only

Inspect

Returns a table (run_id, cagr, sharpe, max_drawdown, turnover, final_equity) for previously run backtests in this session. Unknown run_id -> not_found.

ParametersJSON Schema

Name	Required	Description	Default
`run_ids`	Yes

describe_datasetDescribe dataset

Read-only

Inspect

Returns the schema, coverage and field definitions of one dataset. Raises not_found for an unknown dataset id.

ParametersJSON Schema

Name	Required	Description	Default
`dataset`	Yes	Dataset id.

get_13fGet 13F filings

Read-only

Inspect

Returns 13F holdings matching a query as known on as_of (default today); filings after as_of are hidden.

ParametersJSON Schema

Name	Required	Description	Default
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`query`	Yes

get_barsGet OHLCV bars

Read-only

Inspect

Returns daily OHLCV bars for symbols between start and end, clipped to as_of (default today) so no future data leaks. Max 5000 rows per page; use next_cursor for more.

ParametersJSON Schema

Name	Required	Description
`bar`	No	Bar size, default '1d'.
`end`	No
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`start`	Yes
`symbols`	Yes

get_cotGet COT

Read-only

Inspect

Returns CFTC Commitments of Traders rows for a market between start and end, clipped to as_of. Max 5000 rows per page.

ParametersJSON Schema

Name	Required	Description
`end`	No
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`start`	Yes
`market`	Yes

get_eventsGet events

Read-only

Inspect

Returns corporate/market events of a kind between start and end, clipped to as_of. Max 5000 rows per page.

ParametersJSON Schema

Name	Required	Description
`end`	No
`kind`	Yes
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`start`	Yes

get_fundamentals_pitGet fundamentals (point-in-time)

Read-only

Inspect

Returns fundamentals for one symbol as known on as_of (no restatements from the future). as_of defaults to today.

ParametersJSON Schema

Name	Required	Description	Default
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`symbol`	Yes

get_macro_vintageGet macro vintage

Read-only

Inspect

Returns a macro series as it was actually published by as_of (vintage data, no revisions from the future). Optional start.

ParametersJSON Schema

Name	Required	Description
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`start`	No	Optional start date.
`series`	Yes

get_universeGet universe

Read-only

Inspect

Returns the list of tradable symbols as of a date (index membership is point-in-time, so no survivorship bias). as_of defaults to today.

ParametersJSON Schema

Name	Required	Description	Default
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).
`index`	No	Optional index id.

run_backtestRun backtest

Read-only

Inspect

Runs a deterministic backtest from a JSON spec (universe, start, end, signal, rebalance, top_n, costs_bps, side='long'|'long_short', blind=true to hide tickers). signal.type: momentum, ma_cross, factor, or expr with signal.expr a formula over close prices, e.g. 'rank(ret(252)) - rank(vol(60))' (functions: ret, logret, sma, ema, vol, rsi, high, low, dist_high, lag, rank, zscore, demean, abs, log, sign, clip, min, max, where). Every result includes 'overfitting': trials counted per API key and the deflated Sharpe ratio. Prices are fetched point-in-time with a 400-trading-day lookback buffer and clipped to as_of, so results have no look-ahead. Identical specs on the same snapshot are cached and free. Returns stats, benchmark stats, equity curve, warnings, snapshot id and a disclaimer.

ParametersJSON Schema

Name	Required	Description	Default
`spec`	Yes	Backtest spec.
`as_of`	No	Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC).

search_datasetsSearch datasets

Read-only

Inspect

Full-text search over the dataset catalog. Returns matching dataset ids and descriptions. Free of look-ahead concerns; no as_of needed.

ParametersJSON Schema

Name	Required	Description	Default
`query`	Yes	Search text.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

11 tool updatesOct 13, 2026
- First observedcompare_runs
- First observeddescribe_dataset
- First observedget_13f
- First observedget_bars
- First observedget_cot
- First observedget_events
- First observedget_fundamentals_pit
- First observedget_macro_vintage
- First observedget_universe
- First observedrun_backtest
- First observedsearch_datasets

Related MCP Connectors

Valuein — SEC EDGAR Fundamentals & Smart-Money Data A
io.github.valuein
Point-in-time, survivorship-free SEC EDGAR fundamentals + smart-money signals for AI agents.
Finance Government Data Open Data
222
Stockfacts AOAuth
io.github.AAAZZZR
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
Finance Research & Data
192
FXMacroData A
io.github.fxmacrodata
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
Finance Search Research & Data
5423
Flori Financial Data API A
io.github.goosemafia22-rgb
SEC EDGAR financials, insider trading, and economic data for AI agents. US GAAP + IFRS.
Finance Government Data
2

Related MCP Servers

TickerAPIofficial
Finance Search AI & Machine Learning
tickerdb
A
license
A
quality
A
maintenance
Pre-computed financial market intelligence for AI agents. Stocks, crypto, and ETFs.
Updated a month ago (2026-09-04 00:43 UTC)
9
78 npm
5
MIT
EdgarMCP
Finance Research & Data
birthday-tools
A
license
Not graded
quality
C
maintenance
Provides AI agents with clean, normalized access to financial data including company fundamentals, insider trades, SEC filings, macro series from FRED, real-time quotes, and ETF holdings.
Updated 3 months ago (2026-06-29 01:46 UTC)
MIT
drillr-mcp-serverofficial
Finance Research & Data Search
Little-Grebe-Inc
A
license
Not graded
quality
C
maintenance
Financial data and research MCP for AI agents: filings with full-text and fact search, statements as reported, earnings, insider and institutional ownership, corporate events, executives, analyst data, company discovery and research signals for US, China and Japan equities. Every figure traced to its filing. Browser sign-in.
Updated a month ago (2026-09-13 14:22 UTC)
8
MIT
ai.cabrini/market-data
Finance Research & Data
nlapi
A
license
Not graded
quality
C
maintenance
Provides US stock market data for AI agents, including intraday and daily bars, SEC fundamentals, filings, and insider data, with pay-per-query via USDC on Base.
Updated 3 months ago (2026-07-26 22:52 UTC)
1
MIT