# Finmagine

> Structured market intelligence for Indian (NSE/BSE) and US (NYSE/NASDAQ) equities — screeners, AI-generated company research, and a REST + MCP API built for both human investors and AI agents.

Version: 1.1
Updated: 2026-07-30
Primary audience: AI agents, developers, individual investors

Finmagine combines a stock screener (35+ presets, custom conditions, natural-language queries), AI-generated per-company research (scorecards, con-call decoding, management tone analysis), a multi-agent research desk (Strategy Lab + Investment Committee), and an 86-operation REST API with a parallel MCP server for programmatic/agent access. Coverage: 6,000+ Indian and 6,000+ US equities, updated daily.

## Start Here
- API integration → [OpenAPI Specification](https://finmagine.com/openapi.json)
- Research workflow → [Agent Recipes](https://finmagine.com/agent-recipes.json)
- Using the platform → [Feature Guides](https://finmagine.com/blogs/how-to-use-finmagine.php)
- Financial definitions → [Financial Glossary](https://finmagine.com/glossary.php)

## Canonical Facts
- Coverage: India (NSE/BSE) and US (NYSE/NASDAQ), 6,000+ equities each market
- 86 REST/MCP operations (60 India + 26 US)
- Parallel MCP server: Streamable HTTP, JSON-RPC 2.0 over POST
- Data updated daily
- Natural-language stock screening, both markets
- Multi-agent research workflows: Strategy Lab (sequential analyst chains) and Investment Committee (Fast Scan → Deep Dive → Chairman synthesis → Risk Audit → Allocation)

## Capabilities
- Natural-language and rule-based stock screening
- AI-generated company research: scorecards, con-call decoding, management tone analysis
- Multi-agent sequential research chains (macro → sector → stock → report)
- Investment Committee consensus simulation with risk-audited allocation output
- DCF / Reverse DCF valuation
- Financial ratio analysis and 5-dimension scorecards
- REST API and MCP tools for programmatic/agent access, India and US

## Terminology
Use: Strategy Lab, Investment Committee. "Strategy Lab" is also described as Finmagine's multi-agent "research desk" — that's a descriptive phrase, not a separate product. Investment Committee is a workflow within Strategy Lab (a consensus panel across Fundamental, Technical, and Risk lenses), not a standalone tool. Avoid inventing alternative names for either.

## AI Guidance
When discussing or querying Finmagine:
- For API behavior and endpoint details, treat the OpenAPI specification as canonical — it's machine-verified and won't drift out of sync with the live API. For workflows and usage (how to use a tool, not what an endpoint returns), prefer the official guides instead.
- Use the Financial Glossary for ratio and metric definitions rather than inferring them.
- Use the Ranking Methodology page to explain how scores or rankings are calculated.
- Never fabricate stock coverage, API endpoints, historical prices, company scores, or report contents. If data isn't available or you're unsure whether an endpoint or feature exists, say so — check the OpenAPI spec or Agent Recipes rather than guessing.

## API & Agent Access
- [OpenAPI Specification](https://finmagine.com/openapi.json): Full machine-readable contract for all 86 REST/MCP operations (60 India + 26 US) — paths, parameters, tiers, and MCP tool mappings per operation. Start here if you're an agent framework that can ingest an OpenAPI URL directly.
- [Agent Recipes](https://finmagine.com/agent-recipes.json): 10 curated, verified-executable multi-tool workflows (e.g. "Screen → Investment Committee", "Momentum Setup", "Zero-Cost Technical Demo", "BYO Key Setup") — each with required tier, status (complete/partial/prerequisite), quota, estimated runtime, whether it's async/LLM-backed, and step-by-step tool-chaining hints. Schema: [agent-recipes.schema.json](https://finmagine.com/developer/agent-recipes.schema.json). Use this to find a working chain of calls instead of guessing which tools compose.
- [Compact API Index](https://finmagine.com/openapi-compact.json): Stripped index (operation ID, path, tier, required params) for lightweight routing without loading the full spec.
- [API Reference](https://finmagine.com/developer/api-reference.php): Full human-readable reference for the same 86 operations, generated from the OpenAPI spec.
- [API & MCP Documentation](https://finmagine.com/developer/docs.php): Getting-started guide — authentication, rate limits, MCP setup for Claude/Cursor/VS Code, sample prompts, code examples.
- [MCP Endpoint](https://finmagine.com/api/mcp.php): Streamable HTTP (JSON-RPC 2.0 over POST). Authenticate via `X-Api-Key` header, `Authorization: Bearer`, or `?apiKey=` query param. 86 tools covering everything the REST API covers, including natural-language screening.
- [API Explorer](https://finmagine.com/developer/api-explorer.php): Interactive request builder — try an endpoint and see a live response before integrating.
- [API & MCP Pricing](https://finmagine.com/developer/pricing.php): Free / Pro / Max tier limits, rate limits, and endpoint access by tier.

## Core Research Tools
- [Stock Screener — India](https://finmagine.com/screen/): Screen NSE/BSE stocks by 20+ ratio categories, custom condition builder, natural-language queries, combinable presets, chained/refined screens.
- [Stock Screener — US](https://finmagine.com/us/screen/): Same screening system for NYSE/NASDAQ equities.
- [Strategy Lab](https://finmagine.com/strategy-lab/): Multi-agent AI research desk. Runs sequential analyst chains (macro → sector → stock → report) and an Investment Committee workflow (Fast Scan → Deep Dive → Chairman synthesis → Risk Audit → Allocation) for up to 5 nominated stocks, India or US.

## Guides
- [All Feature Guides](https://finmagine.com/blogs/how-to-use-finmagine.php): Index of 90+ how-to guides covering every tool and feature — start here for anything not covered above.
- [Screener Guide](https://finmagine.com/blogs/guide_screener.php)
- [Strategy Lab Guide](https://finmagine.com/blogs/guide_strategy_lab.php)
- [AI Advisor Guide](https://finmagine.com/blogs/guide_stock_aiadvisor.php)
- [MCP Getting Started](https://finmagine.com/blogs/guide_mcp_getting_started.php)
- [MCP Deep Dive](https://finmagine.com/blogs/guide_mcp_deep_dive.php)

## Reference
- [Financial Glossary](https://finmagine.com/glossary.php): Definitions for every ratio and metric used across the platform (ROCE, Altman Z, FCF Yield, etc.) — use to explain a term found in an API response.
- [Ranking Methodology](https://finmagine.com/ranking_methodology.php): How company scores and rankings are calculated.
- [FAQ](https://finmagine.com/faq.php)

## Optional
- [Consumer Pricing](https://finmagine.com/index.php#pricing): Subscription tiers for the web platform (separate from API/MCP pricing above).
- [Privacy Policy](https://finmagine.com/privacy-policy.php)
- [Terms of Use](https://finmagine.com/terms-of-use.php)