thetadata-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| THETADATA_TIMEOUT | No | Request timeout in seconds | 30.0 |
| THETADATA_BASE_URL | No | Theta Data API base URL | http://127.0.0.1:25503/v3 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
} |
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| stock_list_symbolsA | [FREE] List all traded stock symbols. Updated overnight. |
| stock_list_datesB | [FREE] List available data dates for a stock by request type and symbol. |
| stock_snapshot_ohlcB | [VALUE] Real-time current-day OHLC for a stock. |
| stock_snapshot_tradeC | [STANDARD] Real-time last trade for a stock. |
| stock_snapshot_quoteB | [VALUE] Real-time last BBO/NBBO quote for a stock. |
| stock_snapshot_market_valueB | [STANDARD] Real-time market value derived from last quote for a stock. |
| stock_history_eodC | [FREE] End-of-day report for a stock. Generated at 17:15 ET daily. |
| stock_history_ohlcC | [VALUE] Historical OHLC bars for a stock. Max 1 month per request. |
| stock_history_tradeA | [STANDARD] Tick-level trade history for a stock. Max 1 month per request. |
| stock_history_quoteB | [VALUE] NBBO quote history for a stock. Supports interval aggregation. Max 1 month per request. |
| stock_history_trade_quoteC | [STANDARD] Trade history paired with contemporaneous BBO quotes. Max 1 month per request. |
| stock_at_time_tradeB | [STANDARD] Last trade at a specific time of day for a stock. |
| stock_at_time_quoteC | [VALUE] Last quote at a specific time of day for a stock. |
| option_list_symbolsA | [FREE] List all traded option underlying symbols. Updated overnight. |
| option_list_datesA | [FREE] List available data dates for an option by symbol, request type, and expiration. |
| option_list_expirationsA | [FREE] List available expiration dates for an option symbol. Updated overnight. |
| option_list_strikesA | [FREE] List available strikes for an option symbol and expiration. Updated overnight. |
| option_list_contractsA | [VALUE] List contracts traded or quoted on a date. Supports symbol filtering. Real-time. |
| option_snapshot_ohlcB | [VALUE] Real-time current-day OHLC for an option contract. |
| option_snapshot_tradeC | [STANDARD] Real-time last trade for an option contract. |
| option_snapshot_quoteC | [VALUE] Real-time last NBBO quote for an option contract. |
| option_snapshot_open_interestA | [VALUE] Last open interest for an option contract. Reported ~06:30 ET daily. |
| option_snapshot_market_valueC | [STANDARD] Real-time market value from last NBBO quote for an option contract. |
| option_snapshot_greeks_implied_volatilityC | [STANDARD] Real-time implied volatility from bid, mid, and ask prices. |
| option_snapshot_greeks_allC | [PROFESSIONAL] Real-time greeks for all contracts on an expiration. Use expiration=* for all. |
| option_snapshot_greeks_first_orderC | [STANDARD] Real-time first-order greeks (delta, gamma, theta, vega, rho) for all contracts on an expiration. |
| option_snapshot_greeks_second_orderC | [PROFESSIONAL] Real-time second-order greeks for all contracts on an expiration. |
| option_snapshot_greeks_third_orderC | [PROFESSIONAL] Real-time third-order greeks for all contracts on an expiration. |
| option_history_eodC | [FREE] End-of-day report for options. Generated at 17:15 ET daily. |
| option_history_ohlcA | [VALUE] Historical OHLC bars for options. Max 1 month per request. |
| option_history_tradeB | [STANDARD] Tick-level trade history for options. Max 1 month, requires expiration. |
| option_history_quoteC | [VALUE] NBBO quote history for options. Supports interval aggregation. Max 1 month, requires expiration. |
| option_history_trade_quoteA | [STANDARD] Trade history paired with contemporaneous NBBO quotes for options. Max 1 month, requires expiration. |
| option_history_open_interestA | [VALUE] Historical open interest for options. Reported ~06:30 ET, reflects prior day. |
| option_history_greeks_eodB | [STANDARD] EOD greeks for all contracts by symbol and expiration. Use expiration=* for all. |
| option_history_greeks_allC | [PROFESSIONAL] Historical greeks (all orders) from midpoint prices. Max 1 month per request. |
| option_history_trade_greeks_allB | [PROFESSIONAL] Greeks calculated at each trade. Max 1 month, requires expiration. |
| option_history_greeks_first_orderB | [STANDARD] Historical first-order greeks from midpoint prices. Max 1 month per request. |
| option_history_trade_greeks_first_orderB | [PROFESSIONAL] First-order greeks at each trade. Max 1 month, requires expiration. |
| option_history_greeks_second_orderA | [PROFESSIONAL] Historical second-order greeks from midpoint prices. Max 1 month per request. |
| option_history_trade_greeks_second_orderB | [PROFESSIONAL] Second-order greeks at each trade. Max 1 month, requires expiration. |
| option_history_greeks_third_orderB | [PROFESSIONAL] Historical third-order greeks from midpoint prices. Max 1 month per request. |
| option_history_trade_greeks_third_orderA | [PROFESSIONAL] Third-order greeks at each trade. Max 1 month, requires expiration. |
| option_history_greeks_implied_volatilityC | [STANDARD] Historical IV from bid, mid, and ask prices. Max 1 month per request. |
| option_history_trade_greeks_implied_volatilityC | [PROFESSIONAL] IV calculated at each trade. Max 1 month, requires expiration. |
| option_at_time_tradeC | [STANDARD] Last option trade at a specific time of day. |
| option_at_time_quoteC | [VALUE] Last option NBBO quote at a specific time of day. |
| index_list_symbolsA | [FREE] List all index symbols. Updated overnight. |
| index_list_datesC | [FREE] List available data dates for an index by request type and symbol. |
| index_snapshot_ohlcB | [STANDARD] Real-time current-day OHLC for an index. |
| index_snapshot_priceB | [STANDARD] Real-time last price for an index. |
| index_snapshot_market_valueC | [STANDARD] Real-time market value for an index. |
| index_history_eodB | [FREE] End-of-day report for an index. Generated at 17:15 ET daily. |
| index_history_ohlcC | [STANDARD] Historical OHLC bars for an index. |
| index_history_priceC | [VALUE] Historical price reports for an index. Max 1 month per request. |
| index_at_time_priceC | [VALUE] Index price at a specific time of day. |
| calendar_open_todayB | [FREE] Current day equity market schedule. |
| calendar_on_dateC | [VALUE] Equity market schedule for a given date. |
| calendar_yearC | [VALUE] Equity market holidays for a given year. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 59 tools
Each tool follows a clear pattern of asset class (stock/option/index), data type (list/snapshot/history/at_time), and specific metric (ohlc/trade/quote/greeks/etc.), making them easily distinguishable. Even the many greeks tools are differentiated by order and trade vs. snapshot.
All tool names use a consistent lowercase_with_underscores convention and a predictable structure (e.g., stock_snapshot_ohlc, option_history_trade_greeks_first_order). No mixed conventions or arbitrary verbs.
With 59 tools, the server far exceeds even the 'too many' threshold of 25+. While the granularity may reflect the data API's breadth, it creates an overwhelming selection burden for agents and would benefit from consolidation or parameterization.
The tool surface comprehensively covers listing, real-time snapshots, historical data, at-time queries, greeks, and market calendar information across stocks, options, and indices. No obvious dead ends for typical market data workflows.