historical_price_series
Fetch historical OHLCV price series for any ticker: stocks (AAPL, SAP.DE, 7203.T), ETFs, indices, commodities (GC=F for gold) or cryptocurrencies (BTC-USD). Returns a full date-indexed series of open/high/low/close/volume plus pre-computed statistics: total return, annualised return (CAGR), annua...
This record as markdown: /tools/io-github-getgapup-mcp-knowledge/historical-price-series.md
What historical_price_series does on Mcp Knowledge
AI agents call historical_price_series to retrieve information from Mcp Knowledge without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
async | boolean | — | If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client ti |
period | string | — | Look-back period. Default: 1y. |
ticker | string | Yes | Yahoo Finance ticker symbol. Examples: AAPL (US stock), SAP.DE (Frankfurt), 7203.T (Tokyo), BTC-USD (Bitcoin), GC=F (gold futures), ^GSPC (S&P 500). |
metrics | array | — | Subset of fields to include (informational — all fields always returned). |
adjusted | boolean | — | Adjust close prices for dividends and splits. Default: true. |
interval | string | — | Bar interval. Default: 1d (daily). |
Parameters from the server's own tool schema.
Why historical_price_series is rated Low
This tool purely retrieves and returns historical price data and computed statistics from external data sources (Yahoo Finance, CoinGecko, Stooq). It does not create, modify, delete, or execute any transactions. Despite the financial domain context, the tool itself is a read-only query operation with no capability to move money, place trades, or alter any state.
From the tool's definition Fetch historical OHLCV price series... Returns a full date-indexed series... pre-computed statistics. The tool retrieves and queries historical financial data with no side effects, modifications, or execution of trades.
Attacks that exploit this kind of access
The rule that runs historical_price_series safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Mcp Knowledge, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For historical_price_series, this is the rule to start with:
historical_price_series is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Mcp Knowledge, apply this rule, and every historical_price_series call is checked against it from then on.
Questions about historical_price_series
Fetch historical OHLCV price series for any ticker: stocks (AAPL, SAP.DE, 7203.T), ETFs, indices, commodities (GC=F for gold) or cryptocurrencies (BTC-USD). Returns a full date-indexed series of open/high/low/close/volume plus pre-computed statistics: total return, annualised return (CAGR), annualised volatility, max drawdown and Sharpe estimate (rf=4%). Automatically detects crypto tickers (→ CoinGecko) vs traditional assets (→ Yahoo Finance primary, Stooq fallback). Adjusts for dividends and splits when adjusted=true (default). Use cases: backtesting, factor analysis, performance attribution, charting, financial modelling. Sources: Yahoo Finance, CoinGecko, Stooq. All keyless. Optional env: AICI_RESEARCH_PROXY_URL for Bright Data routing (lifts Yahoo 429), TWELVE_DATA_API_KEY for higher Twelve Data quota. It is categorised as a Read tool in the Mcp Knowledge MCP Server, which means it retrieves data without modifying state.
historical_price_series accepts 6 parameters: async, period, ticker, metrics, adjusted, interval. Required: ticker. The full parameter table on this page comes from the server's own tool schema.
Register the Mcp Knowledge MCP server in PolicyLayer and add a rule for historical_price_series: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Mcp Knowledge. Nothing to install.
historical_price_series is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the historical_price_series rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for historical_price_series. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
historical_price_series is provided by the Mcp Knowledge MCP server (https://mcp.gapup.io). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Mcp Knowledge, and thousands of servers like it.
This server
Across the catalogue