FinzData
REMOTE · API.FINZDATA.COM
Point-in-time stocks, ETFs, futures, GEX, crypto, FX, macro, COT, 13F, ships, ports, flights, power.
Available components
Last scanned (20 hours ago)
Scores higher than 46% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (retire_strategy). See how to fix → View diagnostics → Fail
- HTTPS enforcement could not be verified: the plaintext port answered with HTTP 401, which proves neither a plaintext path nor enforcement. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability76
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 8711 tokens (~152/item across 57 items; 41 tools + 16 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management43
- Stability observed for 13 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage83
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 49% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 43 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (12)
- TLS certificate
- Authorization
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.
- HTTPS in Endpoint SecurityHTTPS enforcement could not be verified: the plaintext port answered with HTTP 401, which proves neither a plaintext path nor enforcement.
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.
- 20 Nov 26 0
- The server rewrote its instructions, which are the text every model session reads security
- 19 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Nov 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- New tool “get_options_eod” functional
- 9 Nov 26 0
- Stability: unverified → 0.03 ▲ functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://api.finzdata.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=finzdata.com | CN=YE1,O=Let's Encrypt,C=US | 10 Oct 2026 | 8 Jan 2027 | ECDSA 256 | ECDSA-SHA384 | 6a1a7d2e2d9adaee20501862ef05af917e4 |
| SANs: *.finzdata.com, finzdata.com | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.finzdata.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| finzdata.com. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.finzdata.com/mcp | Verified | 200 | |
| http (plaintext) | http://api.finzdata.com/mcp | Inconclusive | 401 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
backtest_export Export bars for a backtester ~185
Answers 'give me this stock's bars ready to load into my backtester.' Give a symbol and a framework (backtrader, backtesting_py, vectorbt, zipline, lean, nautilus, freqtrade or qlib); optionally start and end. Returns files (path, encoding, content) plus load_code - write each file at its path, then run load_code. Bars are clipped to as_of; start defaults to 365 days before end. Free keys get the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| framework | string | – | – |
| start | string | – | – |
| symbol | string | yes | – |
No output schema declared.
No examples provided.
backtest_stockcharts_scan Backtest a StockCharts scan ~238
Answers 'backtest my StockCharts scan on real history.' Give a scan and a start date; optionally end, symbols (e.g. a ChartList) to restrict the universe, top_n (default 50) and rebalance (D/W/M/Q, default W). Each rebalance holds the stocks that pass the scan, equally weighted up to top_n, at 10 bps costs, on point-in-time US stocks since 2000 with delisted names included. Returns the translation plus the same stats, benchmark and equity curve as run_backtest. Costs one backtest; free keys cover the last 12 months.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| rebalance | string | – | – |
| scan | string | yes | StockCharts scan text. |
| start | string | yes | – |
| symbols | array | – | Optional universe, e.g. a ChartList. |
| top_n | integer | – | Max names held (default 50). |
No output schema declared.
No examples provided.
claim_mcp_server Claim MCP Server ~80
Answers 'claim this directory listing so I can enable price-accuracy checks for it.' Give the slug of the listing you own; first claimant wins. Returns the claimed slug. If it is already claimed or the slug is unknown, the error says so - contact info@finzdata.com to dispute a claim.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | – |
No output schema declared.
No examples provided.
comment_strategy Comment on a hub strategy ~106
Answers 'ask a question or leave a note on this strategy.' Give a slug and a body (1-2000 characters) - a question, a result from a fork, or a suggested change. Returns the posted comment and the strategy's page URL. Posts a public comment under your handle. If the slug is unknown or private, the error says so - call list_strategies to find a public strategy.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | yes | – |
| slug | string | yes | – |
No output schema declared.
No examples provided.
compare_runs Compare runs ~99
Answers 'which of my backtests performed best?' Give run_ids from earlier run_backtest calls in this session. Returns a table (run_id, CAGR, Sharpe, max drawdown, turnover, final equity) for each run. If a run_id is unknown, the error names it - call run_backtest again to get a fresh run_id, or list_strategies to compare published strategies instead.
| Name | Type | Req | Description |
|---|---|---|---|
| run_ids | array | yes | – |
No output schema declared.
No examples provided.
describe_dataset Describe dataset ~81
Answers 'what fields and coverage does this dataset have?' Give a dataset id from search_datasets (for example prices_daily, cot, gex_daily). Returns the schema, coverage and field definitions. If the id is unknown, the error lists every valid id - call search_datasets to browse them instead of guessing.
| Name | Type | Req | Description |
|---|---|---|---|
| dataset | string | yes | Dataset id. |
No output schema declared.
No examples provided.
fork_strategy Fork strategy ~159
Answers 'copy this published strategy and change one thing.' Give a slug and changes (nested fields merged, e.g. signal lookback 252 to 126); optionally a new title. Returns the fork's slug and page URL. Re-runs the strategy on the server and publishes the fork linked to its parent. Costs one backtest. If the slug is unknown, the error says so - call list_strategies or get_strategy to find a valid slug first.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| changes | object | yes | – |
| slug | string | yes | – |
| title | string | – | – |
No output schema declared.
No examples provided.
get_13f Get 13F filings ~127
Answers 'who owns this stock, and what does this manager hold?' Give a query such as a manager name ('BERKSHIRE') or a ticker ('AAPL'). Returns 13F holdings as known on as_of (defaults to today); filings after as_of are hidden. Free keys get the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| query | string | yes | – |
No output schema declared.
No examples provided.
get_bars Get OHLCV bars ~232
Answers 'what did these stocks do between these dates?' Give symbols (a list, or '/ES' for a futures root - plain 'ES' is the stock Eversource), start and end dates. Returns daily OHLCV bars clipped to as_of so no future data leaks; up to 5,000 rows per page, use next_cursor for more. Covers 16,000+ US stocks since 2000 including delisted names, plus 5,100+ ETFs. Free keys get daily bars for the last 12 months; intraday bars and full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| bar | string | – | Bar size: '1d' (default), or intraday '1m', '5m', '15m', '30m', '1h' (paid bundles). |
| end | string | – | – |
| start | string | yes | – |
| symbols | array | yes | – |
No output schema declared.
No examples provided.
get_cot Get COT ~168
Answers 'how are traders positioned in this market?' Give a market (for example GOLD or CRUDE_OIL) and a start date; optionally end. Returns CFTC Commitments of Traders rows - managed money, producers, swap dealers, leveraged funds and asset managers, long/short/net - clipped to as_of, up to 5,000 rows per page. Covers CFTC COT since 1986. Free keys get the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| market | string | yes | – |
| start | string | yes | – |
No output schema declared.
No examples provided.
get_crypto Get crypto bars ~205
Answers 'what did BTC (or ETH, SOL) do?' Give a symbol (pair, e.g. BTC-USD) and optionally interval (1min, 5min, 15min, 30min, 1hour or 1day, default 1day) plus start and end. Returns OHLCV bars clipped to as_of. Covers 512 crypto pairs (BTC-USD since 2013, ETH-USD since 2016, SOL-USD and more). Free keys get daily bars for the last 12 months; intraday bars and full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| interval | string | – | – |
| start | string | – | – |
| symbol | string | yes | Pair, e.g. BTC-USD. |
No output schema declared.
No examples provided.
get_events Get events ~219
Answers 'when is this earnings report, or the next CPI / payrolls / FOMC release?' Give kind earnings or macro, plus start and end dates. Returns events clipped to as_of, up to 5,000 rows per page. kind=macro returns market-moving releases by default (CPI, payrolls, GDP, PCE, retail sales, claims, ISM and more); pass all_releases=true for every data release. Earnings cover US company report dates; macro covers the full release calendar.
| Name | Type | Req | Description |
|---|---|---|---|
| all_releases | boolean | – | kind=macro only: true returns every data release (hundreds a week); default returns market-moving releases (CPI, payrolls, GDP, PCE, retail sales, claims, ISM ...). |
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| kind | string | yes | – |
| start | string | yes | – |
No output schema declared.
No examples provided.
get_fundamentals_pit Get fundamentals (point-in-time) ~141
Answers 'what were this company's fundamentals as known on this date - before later restatements?' Give a symbol and as_of (defaults to today). Returns SEC fundamentals as filed (earnings yield, book-to-market, ROE, leverage and more) exactly as known on that date. Covers US stocks with fundamentals from 2011. Free keys get the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| symbol | string | yes | – |
No output schema declared.
No examples provided.
get_futures Get futures bars ~354
Answers 'give me every ES contract since 2007' (or any futures market's history). Give a root (ES, NQ, YM, RTY, CL, GC, SI, NG, ZN, ZB, VX, 6E and more; a leading '/' is fine) for the continuous back-adjusted series, or a contract (e.g. ESZ26) for one contract; optionally interval (1min, 5min, 15min, 30min, 1hour) for intraday bars. Returns daily OHLCV and open interest, clipped to as_of. Covers 139 futures markets (CME, CBOT, NYMEX, COMEX, ICE, Eurex, Cboe) with every individual contract since 2007. Free keys get the last 30 days; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| continuous | boolean | – | Back-adjusted continuous series (default true when no contract). |
| contract | string | – | Optional single contract, e.g. ESZ26. |
| end | string | – | – |
| interval | string | – | Bar size: 1day (default), or intraday 1min, 5min, 15min, 30min, 1hour (full Globex session, US Eastern timestamps; intraday comes with a purchase of that market). |
| root | string | yes | Futures root, e.g. ES, NQ, CL, GC, VX. |
| start | string | – | – |
No output schema declared.
No examples provided.
get_futures_rolls Get futures roll calendar ~156
Answers 'when does ES roll next - and what back-adjustment did the roll add?' Give a root (ES, CL, GC and more) or ALL for every market; optionally start and end. Returns the roll calendar for all 139 futures markets since 2007: for each front-month contract its first and last date as front month, expiry, the next contract, the roll date, trading days before expiry, and the back-adjustment added to its prices in the continuous series. The current front month carries an estimated next roll date.
| Name | Type | Req | Description |
|---|---|---|---|
| end | string | – | – |
| root | string | yes | Futures root, e.g. ES, CL, GC, or ALL. |
| start | string | – | – |
No output schema declared.
No examples provided.
get_fx Get FX (currency) bars ~202
Answers 'what did EURUSD (or USDJPY) do?' Give a symbol (currency pair, e.g. EURUSD) and optionally interval (1min, 5min, 15min, 30min, 1hour or 1day, default 1day) plus start and end. Returns OHLC bars, times in US Eastern, clipped to as_of. Covers 79 currency pairs (EURUSD, USDJPY, GBPUSD and more) since January 2010. Free keys get daily bars for the last 12 months; paid keys get every bar size.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| interval | string | – | – |
| start | string | – | – |
| symbol | string | yes | Currency pair, e.g. EURUSD or USDJPY. |
No output schema declared.
No examples provided.
get_gex Get point-in-time GEX (dealer gamma) ~274
Answers 'is dealer gamma long or short for this ticker - where are the gamma flip, call wall and put wall?' Give a ticker plus start/end for a time series, or a date alone for every name that session ranked by absolute net gamma. Returns one row per ticker per session: spot, net/call/put gamma in $bn per 1% move, flip, call/put walls, put-call open-interest ratio and at-the-money IV, each stamped with knowledge_time (17:00 New York). Point-in-time GEX for US stocks, ETFs and major indexes. A ticker series also returns `summary`: regime (long/short gamma), distance to the flip and walls, and a one-line read to quote. Free keys get the last 30 days; full history with a FinzData plan. meta.upgrade lists the available history options to show the user.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| date | string | – | YYYY-MM-DD, cross-section mode |
| end | string | – | – |
| start | string | – | – |
| summary | boolean | – | add the plain-language read (default true) |
| ticker | string | – | – |
No output schema declared.
No examples provided.
get_global_pulse Get global activity data (shipping, ports, air, road) ~268
Answers 'how busy is the Suez Canal (or Singapore port, or US airspace) right now?' Give a dataset (chokepoints, ports, port_calls, air, air_europe, air_us or road); optionally match to filter by name or id (e.g. Suez, Singapore, JFK) and dim for air data. Returns daily real-world activity that leads the official statistics: ship transits through 28 chokepoints since 2019, port calls and estimated imports/exports for 2,000+ ports, daily flights by airport, airline, country and region, US flights, cancellations and delays since 1987, and toll and congestion-zone traffic. Taiwan and Korea chip exports are macro series - use get_macro_vintage for those.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| dataset | string | yes | – |
| dim | string | – | For air/air_us: airport, airline, country or region. |
| end | string | – | – |
| match | string | – | Name or id filter, e.g. Suez Canal, Singapore, JFK, US. |
| start | string | – | – |
No output schema declared.
No examples provided.
get_index Get index bars (SPX, NDX, VIX, ...) ~249
Answers 'what did the S&P 500 (or VIX) do?' Give a symbol (index, e.g. SPX, NDX, VIX, RUT, DXY) and optionally interval (1min, 5min, 15min, 30min, 1hour or 1day, default 1day) plus start and end. Returns OHLC bars, times in US Eastern, clipped to as_of. Covers 123 indexes: S&P 500, Nasdaq-100, Dow, Russell 2000, VIX and its term structure, sector and style indexes, DAX, AEX, the dollar index and Treasury yield indexes. Free keys get daily bars for the last 12 months; paid keys get every bar size.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | – |
| interval | string | – | – |
| start | string | – | – |
| symbol | string | yes | Index symbol, e.g. SPX, NDX, VIX, RUT, DXY. |
No output schema declared.
No examples provided.
get_macro_vintage Get macro vintage ~158
Answers 'what was inflation (or GDP, payrolls, retail sales) as first published on this date - not as later revised?' Give a series id (for example CPIAUCSL) and as_of; optionally start. Returns the series as actually published by as_of, with every vintage kept, across 22,700+ macro series (finzdata.com). Free keys get the last 12 months; full history and every vintage with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| series | string | yes | – |
| start | string | – | Optional start date. |
No output schema declared.
No examples provided.
get_mcp_server Get MCP Server ~87
Answers 'show me this MCP server's listing, tools and probe history.' Give a slug from search_mcp_servers. Returns the listing with tools, probe history, issues and verified-data status, plus its directory page URL. If the slug is unknown, the error says so - call search_mcp_servers to browse servers and copy a valid slug.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | – |
No output schema declared.
No examples provided.
get_options_eod Get end-of-day options chains ~262
End-of-day US options chains since January 2010 for 5,800+ underlyings (stocks, ETFs and indexes, delisted included): every strike and expiry each day with last, bid, ask, bid and ask implied volatility, open interest, volume, delta, gamma, vega, theta and rho. Give symbol and day (YYYY-MM-DD; default the latest day); optional expiry (YYYY-MM-DD) and right (C or P) narrow the chain. Clipped to as_of. Free keys get the last 12 months; FinzData Options EOD gives the full history: one underlying $49, Magnificent 7 + SPY + QQQ $495, every underlying $2,950 (https://finzdata.com/options-eod-data).
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| day | string | – | Trading day YYYY-MM-DD; default the latest day. |
| expiry | string | – | Optional expiry YYYY-MM-DD. |
| right | string | – | – |
| symbol | string | yes | Underlying, e.g. AAPL, SPY, SPX. |
No output schema declared.
No examples provided.
get_political_spending Get political spending (PoliSpend) ~169
Answers 'who is spending election money, where, and on what?' Give a table (races, candidates, donor_geo, race_geo, flows, spending, vendors, state_local, state_local_geo); optionally cycle (2026, 2022 or 2018), state (2-letter code) and office (H or S). Returns cleaned, rolled-up FEC plus state and city filings. Free keys get every race's totals and national/regional/state donor geography; deeper tables need a PoliSpend purchase.
| Name | Type | Req | Description |
|---|---|---|---|
| cycle | integer | – | Election cycle, e.g. 2026 (default), 2022, 2018. |
| office | string | – | – |
| state | string | – | 2-letter state code filter. |
| table | string | yes | – |
No output schema declared.
No examples provided.
get_quant_model Get FinzData Quantitative Model readings ~166
Answers 'what macro regime are we in, and how stressed is the S&P 500?' Give as_of (defaults to today), or nothing for the latest reading. Returns the FinzData Quantitative Model labels as known on that date - financial-conditions and risk direction, growth level and direction, inflation direction, macro quadrant (GOLDILOCKS/REFLATION/STAGFLATION/SLOWDOWN), liquidity and credit - plus the growth/inflation nowcast and the daily S&P 500 market-stress probability. Labels use each input as published on that date, never later revisions.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
No output schema declared.
No examples provided.
get_strategy Get hub strategy ~92
Answers 'show me this published strategy - its spec, backtest and forward record.' Give a slug from list_strategies. Returns the spec, server-computed backtest result, forward-tracking record and fork lineage, plus its public page URL. If the slug is unknown or the strategy is private, the error says so - call list_strategies to browse public strategies.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | – |
No output schema declared.
No examples provided.
get_ticks Get tick trades (every trade print) ~269
Answers 'show me every NVDA trade on this day.' Give a symbol and a day (YYYY-MM-DD); optionally start/end times (HH:MM, US Eastern) to narrow the window, or omit day to list the days available. Returns every trade print (time in UTC nanoseconds and ISO, price, size, exchange, condition codes) for 1,100+ US stocks and ETFs over the last 5 years. Buyers get the trades; other keys get the day's trade count, first and last trade and the history options available. Free sample for every key: all trades on 2026-10-01 for SPY, QQQ, NVDA, AAPL, TSLA, MSFT, AMZN, META, AMD and IWM.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| day | string | – | Trading day YYYY-MM-DD; omit to list available days. |
| end | string | – | Optional end time HH:MM (US Eastern). |
| start | string | – | Optional start time HH:MM (US Eastern). |
| symbol | string | yes | US stock or ETF, e.g. NVDA, SPY. |
No output schema declared.
No examples provided.
get_universe Get universe ~189
Answers 'which US stocks were trading on this date - including ones that later delisted?' Give as_of (YYYY-MM-DD, defaults to today); optionally index top500/top1000/top3000 for the most-traded names priced at least $5 that day, prefix to filter, offset to page through 500 at a time. Returns the symbols trading that day across 16,000+ US stocks since 2000, delisted included. Free keys see the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| index | string | – | Optional liquidity-ranked subset. |
| offset | integer | – | Paging offset (default 0). |
| prefix | string | – | Only symbols starting with this. |
No output schema declared.
No examples provided.
get_verified_record Get Verified Record ~79
Answers 'show me this verified strategy's forward record.' Give a record_id from register_strategy or the verified_board. Returns the record: signal, universe, registration date and every forward result since. If the id is unknown, the error says so - call verified_board to browse records and copy a valid id.
| Name | Type | Req | Description |
|---|---|---|---|
| record_id | string | yes | – |
No output schema declared.
No examples provided.
list_strategies List hub strategies ~145
Answers 'what are the best published strategies on the FinzData Hub?' Optionally sort by benchmark (full record re-run nightly through today; strategies beating their benchmark on return and Sharpe first), robust (deflated Sharpe), forward (forward Sharpe, 63+ days out-of-sample), new or forks; optionally filter by family (momentum, expr, ma_cross, factor) and limit. Returns the matching public strategies; each item carries vs_benchmark, the full-record verdict. Use get_strategy for one strategy's full spec and record.
| Name | Type | Req | Description |
|---|---|---|---|
| family | string | – | – |
| limit | integer | – | – |
| sort | string | – | – |
No output schema declared.
No examples provided.
publish_strategy Publish strategy ~224
Answers 'publish this backtest as a public, reproducible strategy page.' Give a spec (same format as run_backtest), a title (1-120 characters) and your hypothesis (what would falsify it); visibility public or private. Returns the new strategy's slug and page URL. Runs the backtest on the server and publishes it at data.finzdata.com/s/<slug>, forward-tracked daily from today; only server-computed results are stored. Costs one backtest; free accounts may publish 3 a day. Free keys publish over the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| description | string | – | Hypothesis: why it should work and what would falsify it. |
| spec | object | yes | Backtest spec (see run_backtest). |
| title | string | yes | 1-120 characters. |
| visibility | string | – | – |
No output schema declared.
No examples provided.
register_strategy Register Strategy ~170
Answers 'score my signal out-of-sample from today, with a record nobody can edit.' Give agent_name, a signal formula, universe (top500/top1000/top3000/all), rebalance (daily/weekly/monthly), side (long/long_short) and top_frac (0-0.5). The strategy is scored only on data after registration, the record can never be edited or deleted, ranking starts at 63 trading sessions, and FinzData never trades on submitted signals. Returns the verified record id - use get_verified_record to read it back.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_name | string | yes | – |
| rebalance | string | yes | – |
| side | string | yes | – |
| signal | string | yes | – |
| top_frac | number | yes | – |
| universe | string | yes | – |
No output schema declared.
No examples provided.
retire_strategy Retire Strategy ~88
Answers 'stop forward-tracking one of my verified strategies.' Give the record_id you registered. Returns the retired record id. It stops accruing new forward results, keeps its full history and stays public on the Verified board marked retired. If the id is unknown or is not yours, the error says so - call verified_board to find your record's id.
| Name | Type | Req | Description |
|---|---|---|---|
| record_id | string | yes | – |
No output schema declared.
No examples provided.
run_backtest Run backtest ~279
Answers 'would this strategy have worked - without look-ahead or survivorship bias?' Give a JSON spec (universe as a symbol list or top500/top1000/top3000/all, start, end, signal, rebalance D/W/M/Q, top_n, costs_bps, side long or long_short, blind=true to hide tickers). Signals: momentum, ma_cross, factor, or expr formulas over prices and point-in-time fundamentals (from 2011), e.g. 'rank(ret(252)) - rank(vol(60))'. Returns stats, benchmark stats, equity curve, warnings, snapshot id, an overfitting report (trials counted, deflated Sharpe) and a disclaimer. Prices are point-in-time with a 400-day buffer, clipped to as_of; identical specs on the same snapshot are cached and free. Free keys backtest the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| dry_run | boolean | – | true: check the spec and report what would run and what it would cost, without running it or charging. Default false. |
| spec | object | yes | Backtest spec. |
No output schema declared.
No examples provided.
run_strategy Re-run a listed strategy ~176
Answers 'how has this published strategy done since it started?' Give a slug from list_strategies; optionally end (default today). Returns stats, benchmark stats, equity curve, the published spec and the strategy page, re-running the strategy exactly as published on its full point-in-time history. Free on every tier, no API key needed. To change parameters use fork_strategy; to test your own idea use run_backtest (free tier: last 12 months; full history with any purchase).
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| end | string | – | Last date to run through (YYYY-MM-DD). Default today. |
| slug | string | yes | Strategy slug from list_strategies. |
No output schema declared.
No examples provided.
search_datasets Search datasets ~94
Answers 'which FinzData dataset holds this data?' Give a search phrase such as 'crude oil', 'insider trading' or 'housing'. Returns matching dataset ids, titles and descriptions. Use an id with describe_dataset, then call that dataset's tool (for example get_bars for prices, get_macro_vintage for macro). Free; no as_of needed.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Search text. |
No output schema declared.
No examples provided.
search_mcp_servers Search MCP Servers ~120
Answers 'which financial MCP servers can I connect to - and which are healthy?' Give a search phrase q, optionally a category, a minimum grade (A-F) and a limit (1-50, default 10). Returns servers graded nightly by FinzData for health, protocol conformance and prompt-injection risk, with install URLs. Use get_mcp_server for one server's full listing.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | – |
| limit | integer | – | – |
| min_grade | string | – | – |
| q | string | – | – |
No output schema declared.
No examples provided.
star_strategy Star a hub strategy ~99
Answers 'star this strategy so it counts toward Trending.' Give a slug; pass unstar=true to remove your star. Returns the slug, star count and public page URL. Stars feed the Trending list; rankings stay on deflated Sharpe and forward record. If the slug is unknown or private, the error says so - call list_strategies to find a public strategy.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | – |
| unstar | boolean | – | – |
No output schema declared.
No examples provided.
survivorship_audit Survivorship-bias audit ~207
Answers 'how much of this backtest's return is survivorship bias?' Give a spec (same format as run_backtest, universe top500/top1000/top3000 or a symbol list). Returns both stats plus the inflation in CAGR and Sharpe that survivorship bias adds. Runs it twice - once on the point-in-time universe (delisted companies included while they traded, the honest result) and once on only the names still trading today. Costs one backtest. Free keys audit the last 12 months; full history with a FinzData plan.
| Name | Type | Req | Description |
|---|---|---|---|
| as_of | string | – | Point-in-time cutoff (YYYY-MM-DD). Nothing dated after this is returned, preventing look-ahead bias. Defaults to today (UTC). |
| dry_run | boolean | – | true: check the spec and report what would run and what it would cost, without running it or charging. Default false. |
| spec | object | yes | Backtest spec, same as run_backtest. |
No output schema declared.
No examples provided.
translate_stockcharts_scan Translate a StockCharts scan ~154
Answers 'turn my StockCharts scan into a FinzData backtest.' Give a StockCharts scan (e.g. '[type = stock] and [daily close > daily sma(50,daily close)] and [rsi(14) < 70]'). Returns the FinzData signal formula (expr), universe, notes and a ready-to-run backtest spec; clauses not yet supported are listed, never guessed. No data is fetched - call run_backtest with the returned spec, or backtest_stockcharts_scan to run it directly.
| Name | Type | Req | Description |
|---|---|---|---|
| scan | string | yes | StockCharts scan text. |
| start | string | – | Backtest start for the returned spec (default 2015-01-01). |
No output schema declared.
No examples provided.
verified_board Verified Board ~63
Answers 'which verified strategies are leading?' Optionally give limit (1-200, default 50). Returns the leaderboard of verified strategies, ranked on forward results scored only after registration. Use get_verified_record for one record's full detail.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
No output schema declared.
No examples provided.
verify_chain Verify Chain ~65
Answers 'prove no verified record was edited or back-dated.' Give nothing. Returns the hash chain over every verified record so anyone can check the record is intact. If the check fails, the result names the broken link - contact info@finzdata.com with the record id.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
How do I install the FinzData MCP server?
FinzData is a hosted endpoint at https://api.finzdata.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.finzdata.com
claude mcp add --transport http com-finzdata-mcp 'https://api.finzdata.com/mcp'
What is the FinzData MCP server?
FinzData is an MCP server listed in the public MCP registry as com.finzdata/mcp. Point-in-time stocks, ETFs, futures, GEX, crypto, FX, macro, COT, 13F, ships, ports, flights, power. This page covers its hosted endpoint (https://api.finzdata.com/mcp).
Is the FinzData MCP server safe to use?
FinzData scores 65 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the FinzData MCP server expose?
FinzData exposes 41 tools: search_datasets, describe_dataset, get_universe, get_bars, backtest_export, and 36 more. Their descriptions and schemas cost roughly 6,898 tokens of context every time the server is loaded.
Does the FinzData MCP server require authentication?
No. We connected to FinzData without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the FinzData MCP server still maintained?
FinzData is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the FinzData MCP server?
VerifyMCP ran 12 checks on FinzData, covering TLS certificate, Authorization, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about FinzData: HTTPS. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.