MCP tools
The hosted MCP server offers operations of the OpenAPI document as tools, one tool per operation. Connecting, entitlements, and charges are in use with AI assistants (MCP).
Tool names
Each tool is named by its operation's operationId (get_security_quote, get_series_observations, list_news,
run_agentic_research, …) and carries the operation's own description and parameters.
Operations offered as tools
| operations | offered as tools |
|---|---|
| data reads, including digests, theses, themes, and the shared daily research report | yes |
GET /v1/account, GET /v1/account/usage, and GET /v1/auth/tiers | yes |
POST /v1/research/agentic/analyze (a research run) | yes, as run_agentic_research |
| listing research runs, a run's status, cancel, and the stored report | yes |
| deleting a stored report | no |
| the copilot and model inference | no |
| the session archive | no |
GET /v1/auth/whoami | no |
| service status | no |
Every tool
The tools in the order the server lists them, with the operation each calls and the entitlement it needs (entitlements); every key can call a tool marked —.
| tool | operation | entitlement | read-only |
|---|---|---|---|
get_account | GET /v1/account | — | yes |
get_account_usage | GET /v1/account/usage | — | yes |
list_tiers | GET /v1/auth/tiers | — | yes |
get_crypto_asset | GET /v1/crypto/assets/{asset} | data | yes |
get_crypto_history | GET /v1/crypto/pairs/{pair}/history | data | yes |
get_crypto_quote | GET /v1/crypto/pairs/{pair}/quote | data | yes |
get_dataset | GET /v1/datasets/{dataset_id} | data | yes |
get_instrument | GET /v1/instruments/{key} | data | yes |
get_taxonomy | GET /v1/taxonomy | data | yes |
list_datasets | GET /v1/datasets | data | yes |
list_instruments | GET /v1/instruments | data | yes |
get_futures_family | GET /v1/futures/{root} | data | yes |
get_futures_history | GET /v1/futures/{root}/continuous/history | data | yes |
get_futures_positioning | GET /v1/futures/{root}/positioning | data | yes |
get_futures_quote | GET /v1/futures/{root}/continuous/quote | data | yes |
get_futures_technicals | GET /v1/futures/{root}/continuous/technicals | data | yes |
get_fx_history | GET /v1/fx/{pair}/history | data | yes |
get_fx_quote | GET /v1/fx/{pair}/quote | data | yes |
get_fx_reference_rates | GET /v1/fx/{pair}/reference-rates | data | yes |
get_central_bank_rates | GET /v1/markets/rates/central-bank-rates | data | yes |
get_commodity_agriculture | GET /v1/markets/commodity/agriculture | data | yes |
get_commodity_benchmarks | GET /v1/markets/commodity/benchmarks | data | yes |
get_commodity_energy | GET /v1/markets/commodity/energy | data | yes |
get_commodity_livestock | GET /v1/markets/commodity/livestock | data | yes |
get_commodity_metals | GET /v1/markets/commodity/metals | data | yes |
get_commodity_supply_demand | GET /v1/markets/commodity/{root}/supply-demand | data | yes |
get_credit_spreads | GET /v1/markets/credit/spreads | data | yes |
get_cross_asset | GET /v1/markets/cross-asset | data | yes |
get_crypto_market_assets | GET /v1/markets/crypto/assets | data | yes |
get_crypto_market_global | GET /v1/markets/crypto/global | data | yes |
get_equity_indices | GET /v1/markets/equity/indices | data | yes |
get_equity_movers | GET /v1/markets/equity/movers | data | yes |
get_equity_sector_rotation | GET /v1/markets/equity/sectors/rotation | data | yes |
get_equity_sectors | GET /v1/markets/equity/sectors | data | yes |
get_equity_summary | GET /v1/markets/equity/summary | data | yes |
get_fixed_income_etfs | GET /v1/markets/fixed-income/etfs | data | yes |
get_fx_pairs | GET /v1/markets/fx/pairs | data | yes |
get_macro_snapshot | GET /v1/markets/macro/snapshot | data | yes |
get_rate_market_indicators | GET /v1/markets/rates/market-indicators | data | yes |
get_tips_breakevens | GET /v1/markets/rates/tips-breakevens | data | yes |
get_yield_curve | GET /v1/markets/rates/yield-curve | data | yes |
get_yield_history | GET /v1/markets/rates/yield-history | data | yes |
get_news_article | GET /v1/news/{article_id} | data | yes |
list_news | GET /v1/news | data | yes |
search_news | GET /v1/news/search | data | yes |
get_quotes | POST /v1/quotes | data | yes |
get_digest | GET /v1/digests/{ref} | data | yes |
get_market_digest | GET /v1/digests/market | data | yes |
get_security_research | GET /v1/securities/{symbol}/research | data | yes |
list_themes | GET /v1/themes | data | yes |
list_theses | GET /v1/theses | data | yes |
run_agentic_research | POST /v1/research/agentic/analyze | ai | no |
cancel_research_run | POST /v1/research/runs/{run_id}/cancel | ai | no |
list_research_runs | GET /v1/research/runs | ai | yes |
retrieve_research_report | GET /v1/research/runs/{run_id}/report | ai | yes |
retrieve_research_run | GET /v1/research/runs/{run_id} | ai | yes |
get_security_analyst | GET /v1/securities/{symbol}/analyst | data | yes |
get_security_calendar | GET /v1/securities/{symbol}/calendar | data | yes |
get_security_digest | GET /v1/securities/{symbol}/digest | data | yes |
get_security_financials | GET /v1/securities/{symbol}/financials | data | yes |
get_security_history | GET /v1/securities/{symbol}/history | data | yes |
get_security_profile | GET /v1/securities/{symbol}/profile | data | yes |
get_security_quote | GET /v1/securities/{symbol}/quote | data | yes |
get_security_technicals | GET /v1/securities/{symbol}/technicals | data | yes |
get_security_thesis | GET /v1/securities/{symbol}/thesis | data | yes |
list_exchanges | GET /v1/securities/exchanges | data | yes |
list_industries | GET /v1/securities/industries | data | yes |
list_industry_groups | GET /v1/securities/industry-groups | data | yes |
list_sectors | GET /v1/securities/sectors | data | yes |
list_security_corporate_actions | GET /v1/securities/{symbol}/corporate-actions | data | yes |
list_security_events | GET /v1/securities/{symbol}/events | data | yes |
list_security_filings | GET /v1/securities/{symbol}/filings | data | yes |
list_security_insider_transactions | GET /v1/securities/{symbol}/insider-transactions | data | yes |
list_security_institutional_holders | GET /v1/securities/{symbol}/institutional-holders | data | yes |
list_sub_industries | GET /v1/securities/sub-industries | data | yes |
get_series | GET /v1/series/{key} | data | yes |
get_series_history | GET /v1/series/{key}/history | data | yes |
get_series_observations | GET /v1/series/{key}/observations | data | yes |
get_series_projections | GET /v1/series/{key}/projections | data | yes |
get_series_technicals | GET /v1/series/{key}/technicals | data | yes |
get_vix_term_structure | GET /v1/series/vix-term-structure | data | yes |
list_series | GET /v1/series | data | yes |
The research tool
run_agentic_research uses your AI pool
(charges for AI work). It returns one result with content,
events, completion, and complete. A run that did not complete comes back as an error result; treat its content as partial. A
finished call's settled usage is in completion.usage.
The call's first progress message names the run (run: run_…). Use that id to read the run with retrieve_research_run,
stop it with cancel_research_run, and read its stored report with retrieve_research_report, including after a dropped
call; list_research_runs finds a run you no longer have the id for.
Your MCP client's cancellation also stops the call; it is charged like a canceled
research run and returns no usage, so read it with retrieve_research_run.