tijori-finance-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tijori-finance-mcp Show me Titan's revenue mix and recent P&L"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

Tijori Finance MCP
India's first MCP server for Indian equity research.
Talk to 5,000+ NSE/BSE listed companies directly from Claude with India's equity research MCP
What you can do
"Pull Zomato's last 6 quarters of revenue and EBITDA margin, then read their
latest concall transcript — are they hitting the targets management guided for?"
"Bajaj Finance's FII stake dropped 400bps last year while promoters held flat —
pull their latest investor presentation to figure out if this is distribution or passive rotation."
"Crude is up — check the raw materials data for chemical spreads, then pull
revenue mix and operational metrics for Deepak Nitrite to see if margins are at risk.""The goal is to turn data into information, and information into insight." — Carly Fiorina
Related MCP server: Tijori Finance MCP
In Action
1 — Cross-tool deep dive: Titan
Revenue mix pulled first, then cross-referenced against P&L data to explain trends

2 — IndiGo: P&L history
Full income statement history retrieved in one call — revenue, EBITDA, PAT across years

3 — Concall → Financial projection
Knowledge base fetched the latest earnings call transcript, Claude read it and built a forward projection model

Why this exists
Most financial MCP servers are built for US markets — Yahoo Finance, SEC filings, S&P data.
Nothing existed for India.
Tijori Finance is the most comprehensive source for Indian equity data — operational KPIs, revenue segment breakdowns, market share trends, and curated investor documents that aren't available anywhere else. This MCP server exposes all of it to Claude.
Feature | Tijori Finance MCP | Traditional Research | Bloomberg / Refinitiv |
Setup Time | 5 minutes | Hours (Python, Excel...) | Weeks (Contracts) |
Cost | Free + Tijori subscription | Variable | $30k+/year |
Indian Market Coverage | ✅ 5,000+ NSE/BSE stocks | ❌ Fragmented / manual | ✅ |
Operational KPIs | ✅ Segment data, KPIs, market share | ❌ Manual scraping | ✅ Proprietary |
Concall Transcripts | ✅ Earnings calls, investor docs | ❌ PDF hunting | Partial |
AI-Ready Output | ✅ Structured JSON → Claude | ❌ Unstructured pages | ❌ Proprietary only |
API Keys Required | None | Multiple (OpenAI, etc.) | N/A |
A web search gives you unstructured pages. This gives Claude structured, queryable data — historical time series, typed fields, and consistent schemas across all 5,000+ companies. Claude can reason over it, compare across companies, and build analyses — not just summarize a webpage.
Tools
v1 — Stable
Tool | What it does |
| Search any company by name, returns slug |
| Key ratios, forensics score, market cap, PE, ROE, ROCE |
| P&L, Balance Sheet, Cash Flow, Ratios, Quarterly results |
| 10-quarter promoter / FII / DII / public breakdown |
| All operational KPIs with full historical time series |
| Capital allocation breakdown over 1/3/5/7/10 years |
| Segment breakdown with historical trend per segment |
| Market share % per metric with as-of date |
| Annual reports, earnings releases, investor presentations, conference calls — returns URLs grouped by type |
| Fetch and extract full text from a PDF URL returned by |
| Commodity price performance — chemicals, spreads, metals |
| India macro — credit, IIP, GST, auto sales, GDP, trade |
| Index performance — Nifty, sector indices, conglomerates |
| All stocks inside a TJI niche sector index. Pass |
| All companies inside a business group. Pass |
| Resolve slug to numeric company ID |
v2 — Stable
Tool | What it does |
| Browse Tijori's pre-built stock screens, grouped by category, with each screen's description and underlying query |
| Run a popular screen by name ( |
| Search the ~1,500-metric field catalog (with time-period variants like |
What's New
2026-06-12 — Screener overhaul
Alternate data queries. The Advanced Screener's second box now works ad-hoc:
screen_companies({ alternate: "market share > 50" })or{ alternate: "revenue from Defence > 50", filters: "Market Capitalization > 1000" }. Relationships:makes,revenue from,market share,uses,caters to,has plant in, combinable with AND/OR/NOT.The three screener checkboxes.
latest_results_only(only companies that reported the latest quarter),superstar_investors(only companies a whale investor holds, with the holder named per row), andsme(search the SME-listed universe).Popular screens actually run now.
list_popular_screenspreviously returned queries with theANDglued to the next field name (newlines in the page's links were being stripped), and dropped each screen's category, description, market-share query, and superstar-investor flag. It now returns all of those, andscreen_companies { preset: "Monopoly Companies" }runs any of them through the same endpoint the website uses — including the ones advanced queries can't express.The advanced screener exposes Tijori's full query language. Queries support every field in Tijori's catalog,
%values (ROCE > 20%), comparisons between fields (Net Sales > 3Yrs ago Net Sales), and arithmetic (capex/Net Block > 0.5).New
search_screener_fieldstool. Tijori has ~1,500 financial metrics once you count time-period variants (3yr Avg ROCE,5yr Growth Net Sales,10Yrs ago PAT…). Search the catalog to find the exact name, then use it in a query.Result caps + pagination. Screens used to return every matching row (1,000+ for loose queries). Results are now capped at 50 by default (
limitraises it) andoffsetpages through the rest — "show me the next 50" is served instantly from cache without re-querying Tijori.total_resultsalways reports the full count.
2026-06-10 — Reliability & performance
Long, multi-tool queries no longer time out. Asking for a full workup in one go — e.g. "build a model for MTAR: overview + financials + concall + revenue mix + operational KPIs" — used to overwhelm the browser and fail with
page.goto: Timeouterrors. Page loads are now faster (ads, trackers and images are skipped), capped to a safe number of concurrent loads, and retried once on a transient timeout. Tools also wait for the actual data to render rather than a fixed delay, so you get complete results instead of half-loaded ones.Fixed a startup browser leak. A burst of parallel tool calls on a cold start could spin up several Chromium instances and leave most of them orphaned. It now launches exactly one and shares it.
get_market_sharereturns cleanly when there's no data. For companies that simply have no market-share metrics (most non-lenders), it now returns an empty result with a note instead of erroring — which previously made the assistant retry the same call in a loop.
Setup
Requirements
Node.js v18+ — install the LTS version
A Tijori Finance account — free account works but has data limits; Pro recommended for full access
Option 1 — Wizard (recommended)
The setup script handles everything automatically: installs packages, downloads the browser, authenticates, and writes the Claude Desktop config for you.
Windows
Download Node.js and install it (choose LTS)
Download Claude Desktop and install it
Download this repo and unzip it anywhere
Double-click
setup.batinside the folderFollow the prompts — enter your Tijori email/password, then log in through the browser window that opens
Fully quit and reopen Claude Desktop
Mac
Download Node.js and install it (choose LTS)
Download Claude Desktop and install it
Download this repo and unzip it anywhere
Double-click
setup.commandinside the folder — if macOS blocks it ("unidentified developer"), right-click the file and choose Open the first timeFollow the prompts — enter your Tijori email/password, then log in through the browser window that opens
Fully quit and reopen Claude Desktop (Cmd+Q, not just closing the window)
Linux (or any terminal)
git clone https://github.com/LaZZy0v0/tijori-finance-mcp.git
cd tijori-finance-mcp
node setup.jsFollow the prompts, then fully quit and reopen Claude Desktop.
Option 2 — Manual
For those who want to see exactly what each step does.
1. Clone and set credentials
# Mac / Linux
git clone https://github.com/LaZZy0v0/tijori-finance-mcp.git
cd tijori-finance-mcp
cp .env.example .env
# Windows
git clone https://github.com/LaZZy0v0/tijori-finance-mcp.git
cd tijori-finance-mcp
copy .env.example .envOpen .env in any text editor and fill in your Tijori credentials:
TIJORI_EMAIL=your@email.com
TIJORI_PASSWORD=yourpassword2. Install packages and browser
npm install
npx playwright install chromiumnpm install downloads the Node.js dependencies. playwright install chromium downloads a ~150 MB Chromium browser used to maintain your Tijori session — one-time only.
3. Authenticate
node discover.jsA browser window opens at the Tijori Finance sign-in page. Log in as you normally would. Once you're in, the script visits a few pages in the background to capture API endpoints, then the window closes automatically. Your session is saved to output/session.json.
4. Configure Claude Desktop
Find your config file and add the block below. The path to src/index.js must be absolute.
OS | Config file location |
Windows |
|
Mac |
|
{
"mcpServers": {
"tijori-finance": {
"command": "node",
"args": ["C:/Users/yourname/tijori-finance-mcp/src/index.js"]
}
}
}5. Fully quit and reopen Claude Desktop
Test it
"Search Tata Steel using Tijori MCP"
If Claude returns a result, you're connected.
Session expiry
Tijori sessions expire periodically. When tools stop working:
npm run reauthA browser window opens — log in manually and you're back.
How it works
The server uses Playwright to maintain an authenticated browser session with Tijori Finance. Each tool navigates to the relevant page or calls the underlying API, parses the response, and returns structured JSON to Claude. Results are cached in-memory (6 hours for financials, 30 minutes for metrics) to keep things fast.

Disclaimer
This project is not affiliated with Tijori Finance. It requires your own paid Tijori Finance subscription. Use for personal research only — do not redistribute the underlying data.
Built with Model Context Protocol · Data from Tijori Finance
Available Tools
19 toolsfetch_documentA
Fetch and extract text from a Tijori Finance document (PDF). Pass a URL returned by get_knowledge_base. Uses the authenticated browser session to bypass CDN access controls. Returns the full text content and page count.
Inputs: url (required).
get_company_overviewC
Get company overview: key financial ratios, forensics score, market cap, PE, ROE, ROCE.
Inputs: slug (required).
get_conglomerate_constituentsA
Get all constituent companies of a conglomerate group. Pass the tjiid from get_markets({ tab: "conglomerates" }). Returns each company's slug (usable with other tools) and price returns for 1D/1W/1M/3M/6M/1Y/2Y/3Y/5Y/10Y. The conglomerates tab itself shows ROE by year; this tool gives the underlying price performance per stock.
Inputs: tjiid (required).
get_financialsC
Get financial statements. type: pl=Profit&Loss, bs=Balance Sheet, cf=Cash Flow, ratios=Financial Ratios, quarterly=Quarterly Results.
Inputs: slug (required), type (required).
get_fund_flowA
Get capital allocation (fund flow) breakdown over 1, 3, 5, 7, or 10 years. Run resolve_company_ids first.
Inputs: years (required), company_id (required).
get_knowledge_baseA
Get all investor documents for a company: annual reports, earnings releases, investor presentations, conference call transcripts, and curated research links. Returns URLs grouped by document type.
Inputs: slug (required).
get_macro_indicatorsB
Get India macro indicators: industry credit/IIP, demand (GST/auto), or GDP & trade.
Inputs: tab (required).
get_marketsA
Get index performance: headline (Nifty/Sensex/Nifty Bank etc.), niche (TJI sector indices with 1D–5Y price returns — each row includes tjiid for get_sector_constituents), or conglomerates (9 Indian business groups — each row includes tjiid for get_conglomerate_constituents).
Inputs: tab (required).
get_operational_metricsC
Get all operational KPIs for a company with latest values and recent trend. Pass the company slug.
Inputs: slug (required).
get_raw_materialsC
Get commodity price performance for Chemicals, Spreads, or Metals.
Inputs: tab (required).
get_revenue_mixB
Get revenue/segment mix breakdowns for a company. Returns latest % breakdown and full historical trend per segment.
Inputs: slug (required).
get_sector_constituentsA
Get all constituent companies of a TJI niche sector index. Pass the tjiid from get_markets({ tab: "niche" }). Returns each company's slug (usable with other tools), market-cap weight %, equal weight %, and price returns for 1D/1W/1M/3M/6M/1Y/2Y/3Y/5Y/10Y.
Inputs: tjiid (required).
list_popular_screensA
List all pre-built popular stock screens on Tijori Finance, grouped by category, with each screen's name, description, and underlying query. Run one with screen_companies { preset: "" }.
Inputs: no named parameters.
resolve_company_idsA
Resolve a company slug to its numeric company_id. Required before calling get_fund_flow.
Inputs: slug (required).
screen_companiesA
Screen companies by financial metrics and/or business data. Pass 'preset' (a popular screen name from list_popular_screens, e.g. 'Cash Flow Machines'), OR 'filters' and/or 'alternate'. 'filters' accepts a query string like '( ROE > 15 ) and ( Market Capitalization > 500 )' or a shorthand object like {roe:{min:15}, debt_to_equity:{max:0.5}}. Query strings support any field name from search_screener_fields, % values ('ROCE > 20%'), field-vs-field comparisons ('Net Sales > 3Yrs ago Net Sales'), and arithmetic ('capex/Net Block > 0.5'). 'alternate' is a business-data query using relationships: 'makes ', 'revenue from <product/region> > N', 'market share > N', 'uses ', 'caters to ', 'has plant in ' — combinable with AND/OR/NOT, e.g. 'market share > 50' or 'revenue from Defence > 50'. Product/region names come from search_screener_fields with type Products/Regions. Optional flags: latest_results_only (only companies that reported the latest quarter), superstar_investors (only companies a superstar/whale investor holds — adds a 'whales' column), sme (search the SME-listed universe instead of mainboard). 'limit' caps returned rows (default 50) and 'offset' pages through the rest (e.g. offset: 50 for rows 51-100 — served from cache, no refetch); total_results always reports the full match count.
Inputs: sme, limit, offset, preset, +4 more.
search_companyA
Search Tijori Finance for companies by name. Returns name and slug. Use the slug with all other tools.
Inputs: query (required).
search_screener_fieldsA
Search Tijori's screener field catalog (~1,500 financial metrics with time-period variants like '3yr Avg ROCE', '5yr Growth Net Sales', '10Yrs ago PAT', plus product segments and regions). Use to find the exact field name before building a screen_companies query. Example: query 'promoter holding' or 'npa'.
Inputs: query (required), type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a distinct aspect of financial data (e.g., company search vs. financials vs. market indices vs. screening). The descriptions are detailed and include parameter guidance, making it clear when to use which tool.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., search_company, get_financials, list_popular_screens). The verbs (search, resolve, get, fetch, list, screen) are uniformly used and the noun phrases are descriptive.
With 19 tools, the set is slightly above the typical 3-15 range, but each tool has a clear and non-redundant purpose given the broad scope of financial analysis (company data, market data, screening, documents). The count is justified by the domain complexity.
The tool surface covers the full lifecycle of financial research: company identification (search_company, resolve_company_ids), fundamental data (overview, financials, ratios, shareholding, operations, fund flow, revenue mix, market share), market data (indices, sectors, conglomerates, macro indicators), and advanced analysis (screening with field search, presets, and document retrieval). There are no obvious gaps for an investor-focused MCP server.
Maintenance
Related MCP Connectors
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
Research-only MCP server: your AI as a quant research desk. 90 tools, no trades, no brokers.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAI equity-research analyst for Indian NSE/BSE markets with 28 MCP tools enabling sector screens, valuations, SWOTs, and forensic audits using Claude Agent SDK.Apache 2.0
- AlicenseAqualityDmaintenanceIndia's first MCP server for Indian equity research, enabling natural language queries on 5,000+ NSE/BSE listed companies directly from Claude.19MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Indian stock market analysis that provides fundamentals, technicals, DCF valuation, peer comparison, revenue forecasts, and news. It enables natural language interaction with stock data, including full analysis, comparisons, and raw financial data.40 PyPI1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to research Indian stock markets by accessing NSE/BSE corporate filings with measured price reactions, fundamentals, a 108-metric screener, IPO pipeline, FPI flows, results calendar, and daily market briefings through MCP tools.2MIT