MCP App Store
by KeenEthics
Finmagine icon

Finmagine MCP Server for ChatGPT

By Finmagine

Overview

Indian & US stock screeners, financial ratios, AI-generated company research (quarterly summaries, concall tone/credibility decoding), market breadth, momentum ranking, and multi-agent Investment Committee analysis — the MCP server for Indian and US stock market intelligence.

How to connect

  1. ChatGPT: Open the Finmagine listing in the ChatGPT app directory and choose Connect. ChatGPT listing Finmagine exposes 94 tools here.

Tools

allocate_committee_risk

ChatGPT
Deterministic position-sizing: turns committee stances + risk metrics into illustrative allocation weights (max 20% per position, not investment advice). Pure computation, zero LLM tokens. Typically fed the outputs of get_committee_report and compute_committee_risk for the same symbols. Requires api_pro.

cancel_committee

ChatGPT
Cancel a running Investment Committee job started via start_committee. Requires api_pro.

cancel_preset

ChatGPT
Cancel a running Research Preset run started via start_preset. Requires api_pro.

check_committee_status

ChatGPT
Poll an Investment Committee run started via start_committee, by job_id or vps_run_id (at least one required). Terminal states are served from a DB cache; non-terminal polls make a live call to the swarm VPS. Requires api_pro.

check_preset_status

ChatGPT
Poll a Research Preset run started via start_preset. Terminal states (completed/failed/cancelled) are served from a DB cache; non-terminal polls make a live call to the swarm VPS. Requires api_pro.

compute_committee_risk

ChatGPT
Deterministic risk audit: correlation matrix, annualized volatility, max drawdown, beta vs benchmark (Nifty for India / SPY for US), sector concentration, portfolio risk score. Pure computation over price history — zero LLM tokens, no quota. Requires api_pro.

estimate_committee_run

ChatGPT
Preview a start_committee call before spending anything — symbol count, lens list, estimated LLM call count/runtime, and remaining daily quota. Note: this estimates Finmagine LLM call cost only — if include_news_sentiment is later passed true on the real call, that consumes the caller's own separate Alpha Vantage quota (external, BYO, not part of this estimate). No job is started, no quota consumed, no provider called. Requires api_pro.

estimate_preset_run

ChatGPT
Preview a start_preset call before spending anything — symbol/preset validity, remaining daily quota, and a rough runtime estimate. No job is started, no quota consumed, no provider called. Requires api_pro.

fast_scan_committee

ChatGPT
Deterministic PHP-only scoring across 3 lenses (quality compounder / growth / value-safety) for up to 10 symbols — zero LLM tokens, synchronous, does not count against the 5-runs/24h quota. Use this before start_committee to see if a full LLM run is even worth it. Requires api_pro.

get_ai_company_profile

ChatGPT
Full AI research profile integrating concall analysis, financials, and sector context into 10 sections: business model, competitive moat, management quality, growth drivers, risk factors, financial health, industry dynamics, recent developments, investment thesis, bull/bear case. Use this instead of manually synthesising get_financials + get_ratios + get_management_tone for a first-pass research view. Requires api_max.

get_ai_quarterly_summary

ChatGPT
AI-generated earnings summary for an NSE company from the latest concall (DeepSeek, 703 companies covered). Returns headline verdict, key positives, key risks, and management outlook. Use this to understand WHAT happened in the quarter without reading the full transcript. Requires api_max.

get_banking_kpis

ChatGPT
Banking and NBFC operational KPIs from investor presentations: NIM trend, GNPA/NNPA trajectory, CASA ratio, credit growth, PCR. These metrics are not in standard financials — essential for evaluating any bank or NBFC. Returns empty array for non-financial companies; check get_company_profile sector first. Tier: api_pro+.

get_breakout_conditions

ChatGPT
Call this first at the start of any session. Returns whether Nifty 50 is above both EMAs (ABOVE_BOTH), above only EMA-21 (ABOVE_21_ONLY), or below both (BELOW_BOTH). Use with get_market_breadth for a complete market regime picture. Free tier.

get_bulk_block_deals

ChatGPT
Institutional bulk and block deal feed: large buy/sell transactions with counterparty names and deal values. Tier: api_pro+.

get_circuit_stocks

ChatGPT
Stocks that hit upper or lower circuit limits on a given date. Upper circuits with no RS rating = retail-driven micro-cap activity (low quality). Upper circuits among Nifty 500 constituents = institutional momentum worth investigating. Free tier.

get_committee_report

ChatGPT
Fetch a completed (or in-progress) Investment Committee run's full report — per-symbol committee signal, agreement score, research stance, dissent summary, per-lens signals, and a bull/bear debate panel (bull_case, bear_case, what_would_change_view, unresolved_questions — may be null if unavailable). Requires api_pro.

get_company_pead

ChatGPT
Historical Post-Earnings Announcement Drift events for a single NSE company: volume surges and price drift after each results date. Use this to assess whether this stock has a track record of drifting after beats. For the current universe of active PEAD candidates, use get_pead_candidates. Tier: api_pro+.

get_company_profile

ChatGPT
Full fundamental snapshot for an NSE company: PE, ROCE, ROE, D/E, OPM%, market cap, 52-week high/low, RS rating, current price. Use this as the entry point for any single-stock deep dive — it gives the context needed to interpret all other tools.

get_company_scorecard

ChatGPT
Pre-computed composite scorecard combining momentum and fundamental sub-scores into a single ranking. Use this to quickly compare companies without manually scoring get_financials + get_ratios + get_momentum. Omit symbol to get a ranked leaderboard — higher overall_score = better fundamentals + momentum combination. Useful for shortlisting before a full deep dive. Requires api_pro+.

get_concall_decoder

ChatGPT
Structured extraction of management commitments from earnings call transcripts: what they guided for, whether they delivered, capex plans, margin targets, growth outlook. Use this to assess management credibility — a pattern of missed guidance is a red flag regardless of current RS rating. Requires api_max.

get_conglomerate

ChatGPT
Business group (Tata, Adani, Birla, Reliance, etc.) membership and live fundamentals for all group entities. Use this to understand cross-holding structure and group-level capex cycles. Returns 404 if not in a tracked group. Tier: api_pro+.

get_conviction_ranking

ChatGPT
Stocks passing the most simultaneous Finmagine scans (Stage 2, VCP, near-52WH, RS momentum, PEAD, etc.). High scan-overlap count = strongest multi-factor confluence signal. Use this as a starting point for deep dives rather than manually combining screener outputs. A stock appearing in 4+ scans is worth investigating regardless of sector. Tier: api_pro+.

get_corporate_actions

ChatGPT
Historical corporate actions for an NSE stock: stock splits, bonuses, rights issues, buybacks. Requires api_pro+.

get_corporate_actions_feed

ChatGPT
Recent corporate actions across all NSE companies: splits, bonuses, rights, buybacks within a look-back window. Requires api_pro+.

get_daily_prices

ChatGPT
Daily OHLCV + delivery % history for an NSE stock. Delivery % > 60% on a strong up-day signals genuine accumulation (not intraday speculation). Use this to compute N-day price change, identify consolidation bases, or verify volume signature on breakout days. Requires api_pro+.

get_ecs_leaderboard

ChatGPT
Ranked leaderboard of stocks immediately after quarterly earnings, ranked by ECS — where fundamentals (profit growth, margins, cash flow) AND price momentum both confirm the results. Pre-computed — do not manually filter get_financials to derive this ranking. Tier: api_pro+.

get_ecs_score

ChatGPT
Post-earnings quality score (0-100) for a single NSE company: integrates profit growth, sales growth, CFO/profit ratio, margin trend, and PEAD signal. Pre-computed — do not manually derive earnings quality from get_financials. Tier: api_pro+.

get_financials

ChatGPT
Quarterly or annual income-statement summary for an NSE company, newest period first (annual includes a TTM row): sales, EBITDA (operating profit), net profit (PAT) and OPM%, all in ₹ crore except OPM%. Use this to see revenue and OPM% trend over 6-8 quarters. It does not return balance-sheet or cash-flow lines; FCF yield, OCF-to-PAT, net debt and growth rates (CAGR) are pre-computed in get_ratios — do not recalculate CAGRs from this data.

get_forensics

ChatGPT
Forensic evidence for an NSE company from up to five annual periods (chronological, TTM excluded) plus eight quarters: cash flow vs profit (CFO/PAT, mean and pooled), other income as a share of profit (annual and quarterly), receivable days, borrowings, CWIP share, net profit trend, and inventory, payable, cash-conversion and working-capital days (can be negative). Each signal returns its series, latest value, trend, the transparent rule text with threshold and hit flag (true, false, or null when not applicable or not computable) — numbers and flags only, no grade or verdict. Banks, NBFCs and insurers return applicability "limited" with the non-meaningful signals marked applicable:false. Tier: api_pro+.

get_guidance_tone

ChatGPT
Quick concall tone score (0-100): ≥60 = positive, 40-59 = neutral, <40 = negative. Use for rapid screening across many stocks. For multi-quarter tone trajectory and phrase drift analysis on a single stock, use get_management_tone instead. Tier: api_pro+.

get_index_constituents

ChatGPT
All stocks in a named NSE index. Use this to check whether a candidate stock is in a specific index (index inclusion = institutional coverage) or to cross-reference index composition with a sector or momentum filter. Index names must be uppercase: "NIFTY 50", "NIFTY 500", "NIFTY MIDCAP 150". Omit index to list all 30 available index names.

get_industry_stages

ChatGPT
Industry momentum bands for every NSE industry from the latest daily run. Each industry gets a 0-100 composite score (40% RS rating, 30% 1-month return, 30% distance from the 52-week high) and a stage_label: OUTPERFORMING (70+), ACCUMULATING (50-69), CONSOLIDATING (30-49) or UNDERPERFORMING (below 30). The integer stage is derived from that band (OUTPERFORMING=2, ACCUMULATING=1, CONSOLIDATING=3, UNDERPERFORMING=4); it is not a Weinstein classification. Cross-reference with get_sector_rrg for a second, independent read on the same sector. Tier: api_pro+.

get_insider_feed

ChatGPT
Market-wide promoter and director transaction feed. For a single company's history, use get_insider_trades. Tier: api_pro+.

get_insider_trades

ChatGPT
Promoter and director open-market buy/sell transactions for a single NSE company. Distinguishes market-price purchases from ESOP-related transactions. For a cross-company feed, use get_insider_feed. Tier: api_pro+.

get_management_tone

ChatGPT
Deep multi-quarter management tone analysis. Use this (not get_guidance_tone) when you need trend direction: is management confidence improving or deteriorating quarter-over-quarter? Returns tone_trajectory, phrase_drift (language shifts that precede guidance changes), and investor_lens. get_guidance_tone gives a single score; this gives the story behind the score. Requires api_pro+.

get_market_breadth

ChatGPT
Market regime indicator: last 30 days of advances/declines, % stocks above 10/20/40-day MA, Nifty close. A sharp single-day drop to <30% advancers signals broad distribution.

get_market_momentum

ChatGPT
Top NSE stocks ranked by RS rating (IBD-style 1-99 vs Nifty 500). RS ≥ 90 is the platform's "elite momentum" threshold. Cross-reference with get_sector_rrg's Leading sectors to narrow the list to stocks in currently-leading sectors.

get_market_sectors

ChatGPT
Per-sector summary across all NSE companies: stock count, average RS rating, and total market cap. Use this to identify which sectors have the highest average RS before drilling into individual stocks with get_market_momentum. A sector with avg_rs_rating > 70 = broad sector leadership, not just one or two stocks. Free tier.

get_momentum

ChatGPT
Technical momentum signals for an NSE company: RS rating (IBD-style 1-99 vs Nifty 500 universe), EMA-10/21/50 alignment, Stage 2 flag, VCP flag, 52-week high proximity, 30-day RS trend. RS > 85 = elite; price above 10-EMA AND 21-EMA = confirmed uptrend. RS trend direction matters more than the absolute score — an RS rising from 60→75 can be more actionable than a stagnant RS 90.

get_order_wins

ChatGPT
AI-extracted order win announcements for a single NSE company: deal value, client, segment, confidence score. Use this in a deep dive to assess revenue visibility and backlog growth. For a cross-company feed of recent wins, use get_order_wins_feed instead. Tier: api_pro+.

get_order_wins_feed

ChatGPT
Market-wide order win announcements feed across all NSE companies. Use this during event-flow scanning to identify which sectors are winning new business. For a single company's order history, use get_order_wins. Tier: api_pro+.

get_pead_candidates

ChatGPT
Active Post-Earnings Announcement Drift candidates: stocks that recently beat earnings AND show volume + price drift signals, still within the drift window (last 45 days). Tier: api_pro+.

get_pledge_history

ChatGPT
Quarterly promoter pledge % history. Pledge above 20% is commonly treated as a governance risk flag; a rising pledge trend can indicate potential forced-selling overhang. Tier: api_pro+.

get_pulse_events

ChatGPT
Market-wide Pulse feed of recent NSE/BSE corporate events: results, order wins, insider and deal activity, governance, corporate actions, announcements and documents, one row per event with a filing link when the exchange attachment is stored, otherwise a Finmagine company-timeline link. Use this to scan what happened across the market in the last few days. For a single company's timeline use get_company_profile. Order rows carry materiality (order value against trailing revenue) with a computed, approximate or not_computable state. Events are updated each morning from processed disclosures. Tier: api_pro+.

get_ratios

ChatGPT
Pre-computed quality and leverage snapshot (one current row, not a time series): ROCE, ROE, D/E, OPM%, sales growth, P/E, FCF yield, 5-year FCF CAGR, 10-year revenue and PAT CAGR, 3- and 5-year EBITDA CAGR, Altman Z-score, 10-year counts of profitable, FCF-positive and dividend-paying years, 5-year OCF-to-PAT, net debt (₹ crore), pledge % and promoter %. Do not compute CAGRs manually from get_financials — use these pre-calculated values.

get_results_board

ChatGPT
Results Board for NSE/BSE companies: every company that has reported the chosen quarter (default: the latest), with revenue, operating margin, profit after tax and EPS, quarter-on-quarter and year-on-year changes, filtered by market-cap band, industry and Main/SME board, sorted and paged. Use this to scan a results season across the market. For one company use get_financials. Facts only: figures and changes as reported, not a view on any stock. Tier: any key gets the public board; api_pro+ adds ECS band/score, valuation, a this-quarter tag, the since-result move, and the caller's own watchlist/portfolio filter. Premium filters without api_pro+ return premium_required.

get_rs_changes

ChatGPT
Momentum acceleration signals: stocks whose RS rating has improved most over N days. An RS delta > 20 points in 20 days is the platform's "strong acceleration" threshold. Tier: api_pro+.

get_sector_kpis

ChatGPT
Sector-specific operational KPIs extracted from investor presentations — metrics that do not appear in standard financials (e.g. Cement: utilisation %, EBITDA/tonne, realization/tonne; Banks: NIM, GNPA, PCR, CASA; Infra: order backlog, execution rate). Use this to assess operational momentum beyond P&L numbers. Omit period for full trend history. Requires api_pro+.

get_sector_rrg

ChatGPT
Sector rotation coordinates for top-down macro screening. Call this before searching for individual stocks. Quadrants: Leading (RS-Ratio > 100 AND RS-Momentum > 100), Weakening, Lagging, Improving — the standard JdK RRG classification. Tier: api_pro+.

get_shareholding

ChatGPT
Quarterly ownership pattern: promoter, FII, DII, and public holding % over time. FII accumulation (rising FII % over 3+ quarters) is a strong institutional endorsement. Promoter holding decline without a stated reason is a red flag. Requires api_pro+.

get_top_movers

ChatGPT
Daily top gainers and losers by % change across NSE. Use this at session start to read market character: if all top gainers are micro-caps with no RS rating, it is retail-driven (low quality). If large-caps from Leading sectors dominate, it is institutional. Combine with get_circuit_stocks to separate momentum from circuit-driven moves. Free tier.

get_valuation_history

ChatGPT
Historical valuation multiple (P/E, P/B, P/S or FCF yield) for an NSE company over 1y/3y/5y/10y, as one value per month plus statistics: latest, monthly-observation median (use this, not the all-rows median), quartiles, min/max and the latest value's percentile. Also returns the underlying input (TTM EPS, book value per share or TTM sales) as step changes, coverage and sampling disclosure, freshness, a quality block (reliability ok/low/unknown with reasons and the date from which inputs are verified) and the calculation basis. Weekend and holiday rows repeat the prior close. Tier: api_pro+.

list_byo_keys

ChatGPT
List the calling account's saved BYO LLM provider keys (masked, never raw) and the current preferred provider. Call this before start_preset/start_committee to check what's available. No tier gate.

list_committee_runs

ChatGPT
Most recent 20 Investment Committee runs for the calling account (any status). Requires api_pro.

list_preset_catalog

ChatGPT
The 8 available Research Preset definitions (id, market, label, description, approximate runtime, agent count) — call this to discover what start_preset accepts before running one. No tier gate.

list_preset_runs

ChatGPT
Most recent 20 Research Preset runs for the calling account (any status). Requires api_pro.

market_trader_scan

ChatGPT
NSE stocks matching a precomputed technical scan: Stage 2 breakouts, VCP setups, Near-High, High Volume, or Breakout Readiness Score (BRS). Mirrors the /picks/ Trader tab. Refreshed weekdays 12:30 IST. Use allThree for the highest-confluence names (matching multiple scans simultaneously). Requires api_pro.

remove_byo_key

ChatGPT
Remove a saved BYO LLM provider key. If it was the preferred provider, the preferred-provider setting is cleared too. No tier gate.

save_byo_key

ChatGPT
Save (or overwrite) a BYO LLM provider key for the calling account. Format-check only — pass test_and_save:true for an immediate live verification in the same call. No tier gate. Rate-limited: 20/account/hour (test_and_save also counts against the 10/hour test limit). WARNING: this tool argument carries a real, secret provider API key in plain text. Do not send provider secrets through MCP clients you do not fully control — some clients log tool-call arguments. If unsure, save the key via the REST endpoint instead.

screen_natural_language

ChatGPT
Screen NSE stocks using plain English. Examples: "profitable mid-caps with low debt and strong momentum", "large-cap IT stocks with high ROCE and good earnings growth". Converts the query to filter criteria and returns matching stocks. Free-tier users: 20 calls/day. Requires api_base.

screen_stocks

ChatGPT
Final-stage quality filter: screen NSE stocks by ROCE, PE, RS rating, D/E, MCap, sector simultaneously. Use this after identifying the market regime (get_market_breadth) and target sectors (get_sector_rrg) — not as a starting point. Hard cap: 50 results. Requires api_max.

search_companies

ChatGPT
Search NSE-listed companies by name, sector, or financial filters. Use this to find the correct NSE symbol for a company before calling other tools. Also useful for listing all tracked companies in a sector. Returns symbol, name, sector, market cap, RS rating.

set_preferred_byo_key

ChatGPT
Set the account-wide default LLM provider. This is an account default, not a per-task control — presets/committee calls should instead pass a per-call provider hint if they need a specific one, to avoid racing with other concurrent workflows on the same account. No tier gate.

start_committee

ChatGPT
Start a full Investment Committee run — multi-lens LLM analysis + async swarm workflow, up to 10 symbols. Async: returns job_id/vps_run_id immediately with status=running; poll with check_committee_status. No auto-resolve of provider — call list_byo_keys first and pass one explicitly. Quota: 5 runs/24h per account, shared with web usage. Call estimate_committee_run first to preview cost/quota before spending. Requires api_pro.

start_preset

ChatGPT
Start a Research Preset run — a multi-agent analyst chain (Strategy Lab), genuinely separate from Investment Committee. Async: returns run_id/vibe_run_id immediately with status=running; poll with check_preset_status. No auto-resolve of provider — call list_byo_keys first and pass one explicitly. Quota: 10 runs/24h per account, shared with web usage. Call estimate_preset_run first to preview cost/quota before spending. Requires api_pro.

test_byo_key

ChatGPT
Live-verify a BYO LLM provider key against the actual provider (~15s). Pass {provider} alone to re-test the already-saved key (no secret transmitted) — prefer this mode. Pass {provider,model,key} to test an ad-hoc value without saving. No tier gate. Rate-limited: 10/account/hour — this makes a real outbound call to the provider. WARNING (ad-hoc mode only): the key argument carries a real, secret provider API key in plain text. Do not send provider secrets through MCP clients you do not fully control — some clients log tool-call arguments.

us_get_13f_holdings

ChatGPT
Superinvestor 13F holdings data. If symbol provided: shows which tracked funds hold it with value and portfolio %. If no symbol: lists all 14 tracked superinvestors (Berkshire, Pershing, Scion, Appaloosa, Duquesne, etc.). Requires api_max.

us_get_ai_company_profile

ChatGPT
Deep AI-generated company profile for a US stock: 10-section analysis covering business model, financials, competitive moat, management quality, risks, and investment thesis. Updated each earnings cycle. Requires api_max.

us_get_ai_quarterly_summary

ChatGPT
AI-generated one-pager for a US company's most recent earnings: verdict, key KPIs, what went right, what to watch, management guidance, and investor lens. Faster than reading the full report. Requires api_pro.

us_get_breakout_conditions

ChatGPT
SPY Technical Breakout Conditions: evaluates SPY's price relative to its moving averages and returns the US benchmark's breakout regime. This describes SPY itself, not broad-market participation — for that, use us_get_market_breadth. Returns BULL_CONFIRMED, ABOVE_SMA50_ONLY, or BEAR_CONFIRMED regime with SPY price, EMA-20, and RSI-14.

us_get_company_profile

ChatGPT
Full profile for a US stock: price, market cap (USD billions), 52-week range, RS rating, P/E, ROE, operating margin, scorecard score, index membership (SP500/NDX100/DOW30). Free tier restricted to 25 S&P 500 mega-caps: AAPL, MSFT, AMZN, NVDA, GOOGL, META, TSLA, JPM, V, UNH, AVGO, LLY, XOM, MA, HD, PG, COST, MRK, ABBV, CVX, KO, PEP, ORCL, BAC, JNJ.

us_get_company_scorecard

ChatGPT
Finmagine scorecard for US stocks: 5-dimension score (financial_health, growth_prospects, competitive_position, management_quality, valuation) and overall 0–10 score. Omit symbol for ranked list. Requires api_pro.

us_get_concall_decoder

ChatGPT
Structured earnings call decoder for a US company: tone_read, top 3 management messages, topics dodged or downplayed, tone shifts from prior quarter, key numbers from Q&A, management outlook, and investor lens. Requires api_max.

us_get_conviction_ranking

ChatGPT
US stocks appearing in multiple screener presets simultaneously — a quantitative measure of multi-factor conviction. Higher scan_count = passes more screens at once. Requires api_pro.

us_get_ecs_score

ChatGPT
Earnings Catalyst Score (ECS) for a US stock: composite 0–100 score reflecting quality and surprise of recent earnings. Includes revenue/net income YoY and QoQ, percentile ranks, PEAD signal, and actual vs expected EPS. Requires api_pro.

us_get_financials

ChatGPT
Historical financials for a US stock — income statement, balance sheet, or cash flow — annual or quarterly. Key income fields: revenue, netinc, epsdil, ncfo, capex, fcf. Key balance fields: assets, debtnc, assetsc. Requires api_pro.

us_get_full_report

ChatGPT
Full AI research report for a US stock with COMPELLING/WATCHLIST/AVOID stance. Complete fundamental analysis narrative in plain text. Requires api_max.

us_get_index_constituents

ChatGPT
Members of SP500, NDX100 (Nasdaq 100), or DOW30 (Dow Jones 30). Returns symbol, name, GICS sector, RS rating, market cap, P/E, and scorecard score. Use index_name: SP500, NDX100, or DOW30. Requires api_pro.

us_get_insider_trades

ChatGPT
Recent SEC Form 4 insider transactions for a US stock: director/officer name, title, transaction type, shares, price per share, and total value USD. Requires api_pro.

us_get_management_tone

ChatGPT
Management tone analysis across recent earnings calls for a US company: per-quarter tone_read, top messages, dodged topics, and investor lens. Derived from AI-decoded earnings calls. Requires api_pro.

us_get_market_breadth

ChatGPT
US market breadth snapshot: percentage of stocks above SMA-50 and SMA-200, total stocks tracked, and sector-level breakdown. Use this to gauge overall US market health before screening.

us_get_market_sectors

ChatGPT
US sector summary: stock count, average scorecard score, average RS rating, and breadth (% above SMA-50 and SMA-200) for each GICS sector. Use to identify leading vs lagging sectors.

us_get_momentum

ChatGPT
Technical momentum profile for a US stock: RS rating, 1W/1M/3M returns, RSI-14, MACD, EMA-20, SMA-50, SMA-200 with above/below flags, distance from 52-week high, and latest ECS score. Requires api_pro.

us_get_order_wins

ChatGPT
Contract wins and significant agreements for US companies sourced from SEC 8-K filings. Returns contract type, value (USD millions), client name, segment, geography, AI summary, and confidence. Omit symbol for recent cross-company feed. Requires api_pro.

us_get_pulse_events

ChatGPT
Market-wide Pulse feed of recent US corporate events: earnings filings, insider trades, contracts and SEC filings, one row per event with the SEC filing link when stored, otherwise a Finmagine company-timeline link. Use this to scan what happened across the US market in the last few days. For a single company use us_get_company_profile. Order rows carry materiality (contract value against trailing revenue) with a computed, approximate or not_computable state. Events are updated each morning from processed filings. Tier: api_pro+.

us_get_ratios

ChatGPT
Financial ratios for a US stock with classification (Excellent/Good/Average/Poor) and peer percentile. Covers valuation (P/E, P/B, EV/EBITDA), profitability (ROE, margins), growth, leverage, and liquidity. Requires api_pro.

us_get_results_board

ChatGPT
Results Board for US companies: every company that has filed its quarter in the chosen period (default: the latest filings), with revenue, net income, EPS, margins, year-on-year and quarter-on-quarter changes, EPS surprise and the filing form, filtered by market cap, sector and index, sorted and paged. Use this to scan a results season across the market. For one company use us_get_financials. Facts only: figures and changes as filed, not a view on any stock. Tier: any key gets the public board; api_pro+ adds ECS band/score, since-filing move, and the caller's own watchlist/portfolio filter. Premium filters without api_pro+ return premium_required.

us_get_sec_feed

ChatGPT
Recent SEC filings from EDGAR: 8-K material events, 10-K annual reports, 10-Q quarterly reports. Filter by symbol, form type, and lookback days. Requires api_max.

us_get_top_movers

ChatGPT
US top gainers or losers by recent price return. Direction: gainers (default) or losers. Period: 1w (1 week) or 1m (1 month, default). Returns symbol, name, sector, current price, return %, RS rating, market cap in USD billions.

us_market_momentum

ChatGPT
Top US stocks ranked by RS rating (IBD-style 1-99 vs full US universe). RS >= 90 = elite momentum. No tier gate — source data is fully public.

us_market_trader_scan

ChatGPT
US stocks matching a precomputed technical scan: Stage 2, VCP, Near-High, High Volume, or Breakout Readiness Score (BRS). Mirrors /us/picks/?list=trader. Requires api_pro (source data is premium-gated on the web).

us_screen_natural_language

ChatGPT
Screen US stocks using plain English. Examples: "profitable large-cap tech stocks with low debt", "healthcare companies with high ROE and strong earnings growth". Converts the query to filter criteria and returns matching stocks. Uses Groq/Gemini (no Finmagine paid LLM keys). Requires api_max.

us_screen_stocks

ChatGPT
Screen US stocks by fundamentals, technicals, and scorecard. Filters: sector, market cap (USD billions), P/E, ROE, operating margin, RS rating, above SMA-50/200, debt/equity, minimum scorecard score. Returns up to 50 results. Requires api_pro.

us_search_companies

ChatGPT
Search US stocks by name or ticker symbol. Returns symbol, name, sector, industry, market cap (USD billions), and scorecard score. No tier restriction on search — free keys get 10 results, paid keys get up to 50.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/finmagine"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/finmagine)