ForInvest

Global Feed fundamental, analyst and technical data for US equities, addressed by ForInvest codes (e.g. "AAPL:EDGX"). Use for US company profiles/peers, financials, ownership, dividends, analyst recommendations/price targets/EPS, news sentiment, chart patterns, and exchange-based lists. Do NOT use for BIST/non-US markets, standalone symbol discovery (use symbolSearchFlex), or real-time quotes/price history. **Actions:** - companyProfile, peers — company info. - basicFinancials (requires metric, e.g. "all"); financials (requires statement: bs|ic|cf, and freq: annual|quarterly); ownership (exactly one code/symbol); dividends. - recommendation (company-specific analyst history); priceTarget (company price targets, NOT recommendation history); epsEstimate (requires freq); epsSurprises; newsSentiment. - patternRecognition (requires resolution, e.g. "5"); allPatternRecognition (one code/symbol, no resolution). - topPotential, analystRecommendation — exchange-based, require primaryExchange (e.g. "XNAS"), no codes/symbols. Note: recommendation (company) ≠ analystRecommendation (exchange). **Input:** For symbol-based actions provide either `codes` (exact codes like "AAPL:EDGX", sent as-is) OR `symbols` (tickers/names, resolved via us-equity CBOE/EDGX; ambiguous/no match fails — never guess, use symbolSearchFlex). ownership and allPatternRecognition take exactly one. Exchange-based actions take primaryExchange instead. `limit` trims local output only (1-1000; default 100 for ownership/analystRecommendation); ignored for actions that are not list-truncated. Responses are {data:[...]} (no-data/errors use standard MCP responses); list actions add meta {totalCount, returnedCount, truncated}. Time zone: Europe/Istanbul.

globalMarket

Returns historical OHLCV price data for BIST and US market symbols, or tick-level trade data for parity symbols (forex, spot, indices/futures). Two modes: - **Range mode** (from + to): Returns candles within a date range. Use for exact calendar periods. - **Last mode** (last): Returns the most recent N candles/ticks. Use for "last 100 days" queries. Fields (candle): date (ISO 8601), open, high, low, close, volume, amount, weightedAvg, openInterest. Fields (tick): ISO timestamp, last price, bid, ask, amount. Use period: "tick" for forex pairs, spot, foreign indices/futures — NOT for BIST stocks. Large candle responses are auto-summarized (weekly/adaptive, with metadata) once the combined output exceeds ~120 bars or ~24000 chars (whole response, not per symbol). Max 10 codes per request. Optional client-side reduction after normalization (does not change the upstream request): filter → limit → calculate, e.g. {function:"avg",field:"volume"}. For multiple codes it applies per symbol and preserves symbol keys. `last` controls upstream lookback; use `limit` for local output trimming. **Examples:** - Range: codes:["GARAN","ASELS"], period:"1440", from:"20241101000000", to:"20250101000000" - Last: codes:["THYAO"], period:"1440", last:100 - Intraday: codes:["GARAN"], period:"5", from:"20260414094000", to:"20260414180000" - Tick: codes:["EUR/USD"], period:"tick", last:100 Time zone: Europe/Istanbul.

historicalData

Unified KAP data tool for disclosures, asset transactions, business relations, fund details, and fund asset-group distribution. - type="assetPurchase": Returns KAP-disclosed fixed asset purchases (CompanyCode, TransactionDate, TransactionValue, TryEquivalent, AssetTransactionRatio, AssetNature, TransactionImpact, AssetLocation). - type="assetSale": Returns KAP-disclosed fixed asset sales (same fields as assetPurchase). - type="businessRelation": Requires LIC_KAP_INSIGHTS. Returns AI-parsed new business relation insights with sub-modes: - mode="summary": total statistics for a disclosure year. Optional code filters locally. - mode="detail": transaction details for a company and disclosure year. - mode="last": latest new business relation disclosures. - type="fundDetails": Provide exactly one of code, kapFundCode, or legacyCode. - mode="details" (default): KAP fund management, strategy, benchmark, risk, trading/settlement, and fee data when published. - mode="assets": TEFAS/BEFAS asset-group percentages such as equities, deposits, government bonds, and reverse repo. This is not security-level holdings data. - mode="all": Fetches both details and asset-group distribution. Optional client-side reduction (filter → limit → calculate) runs locally. `last` is the upstream KAP retrieval count; use `limit` for local trimming. **Examples:** - kapData with type: "assetPurchase", from: "20230101", to: "20231231", last: 10 - kapData with type: "assetSale", from: "20230101", to: "20231231", last: 10 - kapData with type: "businessRelation", mode: "summary", year: 2025 - kapData with type: "businessRelation", mode: "detail", code: "ASELS", year: 2025 - kapData with type: "businessRelation", mode: "last", last: 10 - kapData with type: "fundDetails", mode: "all", code: "ALE" - kapData with type: "fundDetails", kapFundCode: "AK2" - kapData with type: "fundDetails", mode: "assets", legacyCode: "AK2.FON" Time zone: Europe/Istanbul.

kapData

Resolve the exact field short codes that the `marketData` tool's `fields` parameter expects. Full-text search over the live ForInvest field dictionary (short code ↔ English field name, e.g. l → Last, C → DailyChangePercent, pE → PriceEarning, s1 → SMA(5), DE → Delta). **Why this tool exists:** `marketData.fields` takes short codes (e.g. ["l", "C", "tV"]), NOT human-readable names. Field codes are opaque and must never be guessed. Call fieldSearch to discover the correct code for the metrics you need, then pass those codes to marketData. **Search in English only:** the field dictionary is indexed in English (field names/labels are English regardless of the user's language). Always translate the metric to its English term before searching — e.g. the user asking for "piyasa değeri" → search "market cap", "temettü verimi" → search "dividend yield", "fiyat kazanç" → search "price earning". Searching in Turkish (or any non-English language) returns no results. **When to use:** - Before calling `marketData` with any field beyond the common defaults, to resolve the metric name to its short code. - When the user asks for a specific metric (P/E, RSI, VWAP, market cap, a moving average, an option greek, order-book depth, etc.) and you need its field code. - Common defaults (l=Last, C=DailyChangePercent, tV=TotalVolume, E=Code, h=High, o=Open) are already known; you do not need fieldSearch for those. **Parameters:** - key (optional): A single search term — a metric name, keyword, or partial code (e.g. "price earning", "RSI", "VWAP", "delta", "SMA"). - keys (optional): Multiple search terms; the same where filter applies to all. Returns results grouped under "queries". - At least one non-empty term must be supplied via key or keys. - where (optional): { type } to narrow by value type (e.g. { "type": "NUMBER" }). Supported types: STRING, NUMBER, LONG, INT, TIME. - limit (optional, 1-50, default 15): Maximum matches to return per term. **Returns:** Matching fields with { shortCode, name, display, type }. Use the `shortCode` values in `marketData.fields`. A result may also carry `scope: "stockScreener"` — those are fundamental/meta fields (e.g. grossProfit, sector, ipoDate) that are NOT available through `marketData`; resolve and use them with the `stockScreener` tool instead. Results with no `scope` are live market-data fields usable in `marketData.fields`. **Example queries:** - "P/E ratio" → { "key": "price earning" } → finds pE (PriceEarning) - "RSI" → { "key": "RSI" } → finds r1 (RSI14) - "VWAP" → { "key": "VWAP" } → finds wa (VWAP) - "20-day moving average" → { "key": "SMA" } → finds s3 (SMA20) among SMA fields - "option delta" → { "key": "delta", "where": { "type": "NUMBER" } } → finds DE (Delta) - Multiple metrics at once → { "keys": ["market cap", "dividend yield", "book value"] } Time zone: Europe/Istanbul.

fieldSearch

Returns financial news, KAP announcements, or stock analysis reports. Modes: - "general" (default): Full news with content fetching and attachment parsing. Fields: relatedStock, tags, header, content, attachments, publishDate. Sources: FRKS, KAP, PICNEWS, IHA. Tags: stock codes or category tags (FRKS-W=Son Dakika, FRKS-Y=Analiz, FRKS-A=Ekonomi, FRKS-K=Kripto, FRKS-L=Halka Arz, FRKS-Q=Temettü). gt/lt: ISO date filters. At most 3 entity tags per request; FRKS-* system tags don't count. - "analysis": Lightweight analysis reports per symbol (last 5). Returns grouped by code: RelatedStocks, Tags, AnalysisTitle, ContentUrl, AttachmentUrls, PublishDate. Use codes parameter. Client-side response reduction is applied after normalization and does not change the upstream request: filter selects rows by fields, limit caps rows after filtering, and calculate supports sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "count"} or {function: "avg", field: "PublishDate"}; multiple operations and groupBy are supported in order filter → limit → calculate. In analysis mode, transformations apply independently to each symbol's returned array and preserve symbol keys. The existing last parameter remains the upstream news retrieval count; use limit for local output reduction. **Examples:** - General: mode: "general", source: "FRKS", tags: ["GARAN"], last: 10 - Analysis: mode: "analysis", codes: ["GARAN", "ASELS"] Time zone: Europe/Istanbul.

news

Unified price and fund statistics tool with four modes: - mode="periodic": Returns WTD/WOW/MTD/MOM/YTD/YOY high/low prices with dates, volumes, turnovers, and previous close prices. - mode="changes": Returns percentage and nominal price changes across multiple timeframes (daily, weekly, monthly, 3M, 6M, YTD, 1Y, 3Y, 5Y, all-time). - mode="liquidity": Returns liquidity analysis: market value, trading volumes, transaction ratios, free float data. - mode="fundAnalytics": Returns analytics for 1-20 funds. Fund total value is asset; fund price/return is last/lastChangePercent; investor count is partnerCount; period fund flow is fundFlowTotal. Use .Close as the period-end value of OHLC-style metric objects. assetChangePercent is fund-size change, not investment return. Optional client-side reduction after normalization (does not change the upstream request): filter → limit → calculate, e.g. {function:"avg",field:"WTDVolume"}. For keyed responses it applies per symbol and preserves symbol keys. **Examples:** - mode:"periodic", codes:["GARAN","ASELS"] - mode:"changes", codes:["GARAN","ASELS"] - mode:"liquidity", codes:["GARAN"], period:"1440", from:"20250101000000", to:"20250110000000" - mode:"fundAnalytics", codes:["ALE"], period:"30D", at:"20260731", fields:["asset","lastChangePercent","partnerCount","fundFlowTotal"] Time zone: Europe/Istanbul.

priceStatistics

Returns public offering (IPO) data for Turkish stocks. Modes: - "all": All public offerings list with CompanyCode, CompanyName, PublicOfferingId. CompanyCode may be absent for early-stage offerings. - "calendar": IPO calendar for a year range with full details. from must be less than or equal to to, and the range cannot exceed 3 years. - "detail": Detailed IPO information for a specific company. Optional client-side reduction (filter → limit → calculate) runs locally and does not change the upstream request. **Examples:** - All: mode: "all" - Calendar: mode: "calendar", from: "2024", to: "2026" - Detail: mode: "detail", companyCode: "ARMGD" Time zone: Europe/Istanbul.

publicOffering

Returns real-time snapshot (last price, daily change %, total volume, and custom fields) for BIST and US symbols. Supports sorting. **Field codes:** The `fields` parameter takes short codes, NOT names. Common codes: l=Last, C=DailyChangePercent, tV=TotalVolume, E=Code, h=High, o=Open, pc=PreviousClose, dt=DateTime, D=Date. For ANY other metric (P/E, RSI, VWAP, market cap, moving averages, option greeks, etc.) resolve the exact code with the `fieldSearch` tool first — never guess. If `fields` is omitted, defaults to l, C, tV, E. **Not in this feed:** the real-time snapshot does NOT carry order-book depth (bid/ask levels such as b1/b2/a1, quantities q1/k1, etc.). Requesting those codes returns a `_dataNotes` entry listing them as unavailable; report them as unavailable instead of retrying. Optional client-side reduction runs after the snapshot (does not change the upstream request): filter → limit → calculate. Example: {function:"avg",field:"DailyChangePercent"}. Time zone: Europe/Istanbul.

marketData

Skill management tool with two actions: - "index": Returns the in-memory skill index containing all active skill keys, descriptions, and MCP tool names. Used by the ForMind client to cache the skill list for routing decisions. - "load": Loads one or more skills by key and returns a versioned skill bundle with selected skill versions, merged instructionsMarkdown, an explicit all/allowlist tool policy, canonical tool names, live tool schemas, and validation warnings. **Examples:** - Index: action: "index" - Load: action: "load", keys: ["market-overview"] Time zone: Europe/Istanbul.

skills

Screens Borsa İstanbul equities or ranks TEFAS/BEFAS funds. scope="stock" (default): Filters BIST equities by multi-criteria. Filter fields by category: Definition (code, status, sector, index, subMarket, shortSalePolicy), Price (open, close, last, high, low, vwap, dailyChangePercent, weeklyChangePercent, monthlyChangePercent, moMonthlyChangePercent, yearlyChangePercent, volatility, totalTurnover, totalVolume), Moving Averages (sma5, sma8, sma10, sma20, sma50, sma100, sma200 and matching ema fields), Valuation (marketValue, marketValueUSD, priceEarning, priceBookValue, earningPerShare, bookValue, capital), Profitability (returnOnEquity, grossMargin, netMargin, returnonAssets, grossProfit, netProfit, ebitda, netSales), Ownership (freeFloatRate, dividendYield, individualInvestorRatio, institutionalInvestorRatio). Operators: eq, neq, gt, lt, gte, lte, in, nin, between (2-element array), exists. Value semantics: ROE/ROA/margins are decimals (0.20 = 20%). dividendYield/freeFloatRate are percentage points (3 = 3%). Stock price-change periods: monthlyChangePercent is month-to-date (MTD, since the previous month-end close); moMonthlyChangePercent is trailing one-month change (rolling). For "son 1 ay" / "past one month" performance or rankings, use moMonthlyChangePercent. Use monthlyChangePercent only for "ay başından beri" / "month-to-date" requests. If the upstream result exceeds 100 rows, the tool returns the first 50 rows and asks the caller to narrow the filters. scope="fund": Returns the current top or bottom funds in one fund category. This is ranking, not arbitrary numeric screening. Required category values: YF, EYF, GMF, GSF. Use lastChangePercent for fund-price return, asset for fund size, assetChangePercent for fund-size change, partnerCount for investor count, and fundFlowTotal for period fund flow. Use .Close as the period-end value of OHLC-style metric objects. Top/bottom fund analytics always uses today's date and does not accept an at parameter. Note: `filters` performs upstream screening conditions; the separate `filter` applies optional local post-processing (filter → limit → calculate), which does not change the upstream request. **Examples:** - Stock: filters=[{field:"priceEarning",op:"between",value:[5,15]},{field:"returnOnEquity",op:"gte",value:0.20}], fields=["open","last"] - Fund: scope="fund", fundCategory="YF", period="30D", direction="TOP", sortBy="lastChangePercent", size=10 Time zone: Europe/Istanbul.

stockScreener

Supply-demand active trade analysis. Returns bid volume (bv), ask volume (av), total volume (tv), volume difference (vd), and percentages (bvp, avp, vdp) for the last N minutes. Supported periods: 5, 10, 15, 30, 60, 1440 minutes. Optional client-side reduction (filter → limit → calculate) runs locally per symbol and preserves symbol keys. **Example:** supplyDemandLastMinutes with codes: ["GARAN", "AKBNK"], last: 60, filter: {field: "vd", op: "gt", value: 0}, limit: 10 — parallel execution. Time zone: Europe/Istanbul.

supplyDemandLastMinutes

Returns server-calculated technical indicators. Never compute them from OHLCV. - mode "latest" (default): Latest point per symbol. - mode "history": Last outputCount points per symbol (default 2) for crossover checks. Both support multiple codes. from/to returns a single-symbol series; omit mode, outputCount and last. Output: {date, OHLCV, ...indicator values}. Single-value indicators as flat keys (ema50, rsi14); multi-value as objects (macd_12_26_9: {value, signal, histogram}). Indicator syntax — "param1:value-param2:value": - Single-param (per:N): ADX, ADXR, ARO, ATR, CCI, DEMA, DX, EMA, MOM, RSI, SMA, TEMA, TSF, WIL, WMA - Two-param: APO/PPO (fast:N-slow:N), SAR (acc:N-max:N), VOL (per:N-dev:N), ENVE/ENVS/ENVW (per:N-perc:N), STOF (fastk:N-fastd:N), T3 (per:N-vfactor:N) - Three-param: BOL (per:N-devu:N-devd:N), MACD (fast:N-slow:N-sig:N), STOS (fastk:N-slowk:N-slowd:N), STOCHRSI (fastk:N-fastd:N-per:N) - PVT: "classic" | "camarilla" | "fibonacci" | "woodie" Note: short `last` lookback can yield missing/unstable RSI/MACD. `outputCount` cannot exceed `last`. **Examples:** - Latest: codes:["GARAN","ASELS"], period:1440, indicators:[{"RSI":"per:14"},{"MACD":"fast:12-slow:26-sig:9"}] - History: mode:"history", codes:["GARAN"], outputCount:2, indicators:[{"MACD":"fast:12-slow:26-sig:9"}] - Range: codes:["GARAN"], period:1440, from:"20251101000000", to:"20251201235959", indicators:[{"RSI":"per:14"}] Time zone: Europe/Istanbul.

technicalIndicator