tearsheet
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., "@tearsheet Compare TCS and Infosys revenue growth over the last 3 years"
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.
tearsheet
tearsheet is an MCP server for researching companies listed in India. It reads Tijori Finance through a local headless browser and checks quarterly figures against XBRL filings you download yourself.
It runs on your machine over stdio. Version 0.2.0 is alpha.
tearsheet isn't affiliated with or endorsed by Tijori Financial Services, NSE or BSE. Read docs/DATA-USE.md before using it.
Requirements
Python 3.12 or later
Chromium for Playwright, installed below
An MCP client that can launch stdio servers, such as Claude Code or Claude Desktop
Related MCP server: InvestSights Indian Stock Research MCP
Install
tearsheet isn't on PyPI yet. Install it from source:
git clone https://github.com/kewonit/tearsheet.git
cd tearsheet
uv sync
uv run playwright install chromiumAdd it to a client
Claude Code:
claude mcp add tearsheet -- uv --directory /path/to/tearsheet run tearsheetClaude Desktop and other clients take this in their MCP settings file:
{
"mcpServers": {
"tearsheet": {
"command": "uv",
"args": ["--directory", "/path/to/tearsheet", "run", "tearsheet"]
}
}
}Tools
Tools that take a company accept its name, NSE symbol or BSE code. docs/TOOLS.md lists every parameter.
Tool | Returns |
| Name, NSE symbol, BSE code and Tijori slug |
| Delayed price, market cap, P/E, PEG, key ratios, 3- and 5-year averages, price changes, dividends and dated events |
| Income statement, balance sheet, cash flow, quarterly results, ratios or fund flow |
| Shareholding by quarter, with each row's change from the previous quarter |
| Company-specific KPIs, such as capacity, volumes or deal wins |
| Revenue split by product, region or segment, and market shares with their dates |
| Exact screener field names, with units |
| Companies matching a financial condition, a business filter or a preset |
| 2 to 6 companies side by side, with growth, 3-year CAGR and peer minimum, median and maximum calculated by tearsheet |
| Headline indices, sector indices and conglomerates. Sectors and conglomerates include constituents |
| Pages and figures in your filings that match a query |
| PDF pages, or XBRL figures in crore with their periods |
| One quarterly figure from Tijori beside the filed figure |
| Session state, cache contents and filing count. Works offline |
Prompts: earnings_review, peer_comparison and thesis_check.
Results
Every tool returns the same envelope, as structuredContent with a declared output schema and as compact JSON text:
{
"data": {},
"entity": {"name": "Example Ltd", "nse": "EXAMPLE", "bse": "500000"},
"as_of": "2026-09-30",
"retrieved_at": "2026-11-08T04:30:00Z",
"units": {"currency": "INR", "scale": "crore"},
"sources": [{"provider": "tijori", "url": "https://www.tijorifinance.com/company/example/financials/"}],
"verification": {"status": "matched", "detail": "Checked against filings: revenue Sep 2026."},
"warnings": []
}Field | Meaning |
| Money is in crore unless a row states otherwise |
Row | One of |
Period labels |
|
| No reliable figure exists. A warning gives the reason |
|
|
| Anything that affects how to read the data |
Errors return code, message, retryable and, where useful, hint. The codes are listed in docs/ARCHITECTURE.md.
Plan access
Data | Free plan or signed out | Paid plan |
Statements, ratios, fund flow, ownership, screens, sectors | Yes | Yes |
Latest operating metrics, revenue split and market shares | Yes | Yes |
History of operating metrics, revenue split and market shares | No | Yes |
Premium screen presets | No | Yes |
tearsheet reads the plan from the signed-in session's company pages and returns only what that plan shows there. Some Tijori responses include history even for free accounts. On a free plan tearsheet keeps only the latest value from them, caches nothing else, and never calls the revenue mix history endpoint.
Sign in
Only needed for paid-plan data.
uv run tearsheet loginThis opens Chromium on Tijori's sign-in page. You sign in there, so tearsheet never handles your password. When Tijori sets a session cookie, tearsheet saves the browser session to ~/.tearsheet/session.json with owner-only permissions and closes the window. It waits up to 10 minutes. If a sign-in method is refused in that window, use another.
tearsheet login has been tested against a local sign-in page, not yet against Tijori's.
Filings
tearsheet never downloads filings, because NSE and BSE prohibit automated collection. Download them yourself into ~/.tearsheet/filings:
File | Source | Naming |
Quarterly results, XBRL | NSE, Integrated Filing - Financials (results from 2025 on) | Any name. The file states its company |
Annual reports and transcripts, PDF | NSE, BSE or the company's website | Inside a folder named after the NSE symbol or BSE code, such as |
With a matching XBRL filing, get_financials checks quarterly revenue, profit before tax and net profit. A figure matches when it is within ₹5 lakh or 0.01% of the filed value, whichever is larger. Tijori rounds to two decimals in crore, so anything wider is a real difference.
Tested on integrated filings from a manufacturer, an NBFC, a bank and a life insurer. In those, Tijori's profit before tax differed from the statutory figure for the bank (by its minority interest) and the insurer, and tearsheet reports both as mismatches. General insurers and results filed before 2025 are untested.
Files and settings
Variable | Default | Contents |
|
|
|
|
| Filings you downloaded |
tearsheet sends at most one request a second to Tijori, two at a time, and none to NSE or BSE.
Limitations
Prices are delayed.
Figures are Tijori's. Only quarterly revenue, profit before tax and net profit can be verified, and only for quarters with a filing.
tearsheet parses Tijori's pages and private endpoints. When their shape changes, tools return
UPSTREAM_CHANGEDinstead of partial data.Some of Tijori's presets fail on Tijori's side. tearsheet returns Tijori's error.
Tijori doesn't expose ISINs.
Not investment advice
tearsheet returns facts and calculations. It doesn't recommend buying, selling or holding anything, can't place orders, and isn't registered with SEBI as an adviser or research analyst.
Development
CONTRIBUTING.md covers setup, test suites and releases. docs/ARCHITECTURE.md describes the design. Report vulnerabilities as described in SECURITY.md. Changes are in CHANGELOG.md.
Licence
Available Tools
14 toolscompany_snapshotARead-only
Get a one-call overview of a listed Indian company.
Returns identifiers, status, size class, delayed price, market cap, P/E,
PEG, key ratios with their units, multi-year ROE and margin averages,
price changes up to one year, recent dividends and dated key events.
Use it first when asked about a company in general. It contains facts
only: Tijori's own opinions and forecasts are deliberately left out.
Longer-term returns are omitted because their basis isn't stated.
Inputs: company (required). Returns: data, as_of, units, entity, +5 more
compare_companiesARead-only
Compare 2 to 6 companies side by side on valuation, returns and growth.
Growth is calculated here from annual figures, never from TTM or
interim columns: revenue and net profit growth in the latest year,
and three-year revenue CAGR. Growth is blank where it isn't defined,
such as from a loss. Also gives the minimum, median and maximum of
each figure. For a company's own peer list, see company_snapshot.
Inputs: companies (required). Returns: data, as_of, units, entity, +5 more
find_companyARead-only
Find a listed Indian company and its identifiers.
Accepts an NSE symbol, a BSE code, a company name or part of one. Returns
each match's name, NSE symbol, BSE code and slug, plus what it matched on.
Use this when a name is ambiguous or you need the identifiers. Other tools
accept the same input, so you don't need to call this first. An empty
match list means nothing was found. ISINs aren't available. Check the
warnings: if the input wasn't a real symbol, they give the actual one.
Inputs: query (required). Returns: data, as_of, units, entity, +5 more
get_business_mixARead-only
Get how a company's business splits, and its market shares.
Returns the latest revenue split by product, geography, segment or other breakdowns Tijori tracks, each in percent, plus market share figures. Every market share has its own as-of date, and some are years old, so always check it. History of the revenue split and of market shares needs a paid Tijori plan.
Inputs: company (required). Returns: data, as_of, units, entity, +5 more
get_financialsARead-only
Get a company's financial statement.
Covers income statements, balance sheets, cash flow, quarterly results,
ratios, and fund flow, which shows where money came from and went over
trailing windows of 1 to 10 years. Accepts an NSE symbol, BSE code or
name. Every row states its own unit, because statements mix crore,
percent, days and multiples. A unit of as_reported means the unit isn't
known, so don't assume one. A period starting TTM is trailing twelve
months, and one starting Interim covers an unstated period, so don't
compare either directly with annual columns. A blank value means no
reliable figure exists. If the requested basis doesn't exist, the other
is returned with a warning. Set detail to full for line items. Quarterly
figures are checked against any matching filing in the filings folder,
and the verification field says how that went. Other statements are
Tijori's figures, unchecked.
Inputs: company (required), basis, detail, periods, +1 more. Returns: data, as_of, units, entity, +5 more
get_operating_metricsARead-only
Get a company's operating metrics, such as capacity, volumes or deal wins.
These are company-specific KPIs beyond the financial statements. Many smaller companies have none, which returns an empty list. Use metric to filter by part of a name. Each metric has its own unit. With Tijori's free plan only the latest value is available, matching what Tijori's own pages show, and history needs a paid plan.
Inputs: company (required), limit, metric. Returns: data, as_of, units, entity, +5 more
get_ownershipARead-only
Get a company's shareholding pattern by quarter.
Returns promoter, institutional and public holdings in percent, the number of shareholders, and each row's change over the last period. Concise gives categories. Full adds the named holders that companies must disclose above 1%. Use it for questions about who owns a company or how ownership is changing.
Inputs: company (required), detail, periods. Returns: data, as_of, units, entity, +5 more
get_sector_viewARead-only
Get market indices, Tijori's sector indices or conglomerate groups.
Without a name, lists them with their price changes over periods such
as 1D, 1M and 1YR*. With a name, such as "Private Bank" or "Adani",
also returns that sector's or group's constituent companies and their
weights. Tijori marks some periods with an asterisk and doesn't say
what it means, so mention that when quoting them.
Inputs: kind, name, limit. Returns: data, as_of, units, entity, +5 more
read_filingARead-only
Read part of one filing from the filings folder.
Give a file name as search_filings returns it. For a PDF, pages picks a
page or range such as "4" or "4-6", up to ten pages. For an XBRL
results filing, returns the company, period and basis, and its figures
with money in crore and each figure's own period, because a filing for
a second quarter also holds half-year figures. Breakdowns are left out.
Only files inside the filings folder can be read.
Inputs: file (required), pages. Returns: data, as_of, units, entity, +5 more
reconcile_figureARead-only
Check a quarterly figure from Tijori against the company's own filing.
metric is revenue, profit_before_tax or net_profit, and period is a
quarter such as "Sep 2026". Needs that quarter's XBRL results filing in
the filings folder. Returns both figures in crore and their difference.
The verification status says matched, mismatch or unchecked, with the
reason.
Inputs: metric (required), period (required), company (required), basis. Returns: data, as_of, units, entity, +5 more
screen_stocksARead-only
Find listed companies matching conditions, across the whole market.
financial is a condition on exact field names, such as
"Market Capitalization > 1000 AND ROCE > 20%". Find names with
search_screen_fields. business filters on what companies do, such as
"makes Steel" or "has plant in Gujarat". Or pass a preset name instead.
Results are checked to make sure Tijori applied every filter. Use
sort_by with a column name, and pass next_cursor back to page through
results. Main board by default; set sme for SME listings.
Inputs: sme, limit, cursor, preset, +6 more. Returns: data, as_of, units, entity, +5 more
search_filingsARead-only
Search the filings the user downloaded into their filings folder.
Searches PDF text, such as annual reports and concall transcripts, and
the figure names in XBRL results filings. company narrows to one
company by NSE symbol, BSE code or name. Works offline. Returns the file
and page of each hit, which read_filing can then open.
Inputs: query (required), limit, company. Returns: data, as_of, units, entity, +5 more
search_screen_fieldsARead-only
Find exact screener field names, with their units and periods.
screen_stocks needs exact field names, such as "ROCE" or "3yr Avg ROCE".
Search by words, like "roce" or "debt equity". Also lists the preset
screens when query is "presets". Searching is local and cheap.
Inputs: query (required), limit. Returns: data, as_of, units, entity, +5 more
server_statusARead-only
Report whether tearsheet is ready to use.
Shows whether a Tijori session is saved, what is in the local cache and how many filings the user has added. Call this first if another tool fails, or when the user asks why data is missing. It works offline and never contacts Tijori, so a saved session may still have been ended on Tijori's side. It returns no company data.
Inputs: no named parameters. Returns: data, as_of, units, entity, +5 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool targets a fairly distinct facet of company research (financials, ownership, business mix, operating metrics, screening, comparison, sectors, filings, reconciliation), and the descriptions explicitly route between them, e.g. search_screen_fields before screen_stocks and search_filings before read_filing. The main soft overlap is company_snapshot versus get_financials/get_ownership, since the snapshot includes ratios and dividends that also appear elsewhere, but the 'use it first for a general question' framing mostly resolves it.
Most names follow a verb_noun pattern (get_financials, get_ownership, search_filings, read_filing, compare_companies, reconcile_figure), all snake_case. Two names break the verb-first convention: company_snapshot and server_status are noun-first, a minor but noticeable deviation.
14 tools sit comfortably in the well-scoped range, and each covers a genuinely different operation (company fundamentals, screening, filings, reconciliation, health check). No tool looks redundant or padded.
Coverage is strong for equity research: identifiers, overview, statements, ownership, business mix, KPIs, market-wide screening, peer comparison, sector views, local filing search/read, and figure verification, plus a status tool as a diagnostic. The notable gaps are price history beyond one year (deliberately omitted) and corporate events/announcements or news beyond what the snapshot surfaces.
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 U.S. public companies from their SEC filings: financials, XBRL facts and filing text.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
The filed record of India's listed companies, every figure tied to the filing it came from.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides financial data for Indian listed companies from screener.in, enabling users to search companies and fetch financial statements, ratios, and peer comparisons.225 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform deep Indian stock research with fundamentals, forensic scores, DCF valuation, screening, and news for 6000+ NSE/BSE stocks.19 npm1MIT
- AlicenseAqualityDmaintenanceEnables LLM clients to perform fundamental analysis of NSE/BSE-listed Indian stocks, covering financial statements, ratios, valuation, screening, and investment memos using Yahoo Finance data.281MIT

DocStoXofficial
AlicenseNot gradedqualityCmaintenanceConnects AI assistants over the Model Context Protocol to live NSE and BSE data, enabling research on Indian listed companies — quotes and price history, quarterly and annual fundamentals, valuation and peer comparison, shareholding, FII/DII flows, F&O and index options, screening, IPOs, corporate actions, filings and market news. Read-only, with no local setup required.MIT