Skip to main content
Glama
tearsheet

tearsheet

by kewonit

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

  • uv

  • 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 chromium

Add it to a client

Claude Code:

claude mcp add tearsheet -- uv --directory /path/to/tearsheet run tearsheet

Claude 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

find_company

Name, NSE symbol, BSE code and Tijori slug

company_snapshot

Delayed price, market cap, P/E, PEG, key ratios, 3- and 5-year averages, price changes, dividends and dated events

get_financials

Income statement, balance sheet, cash flow, quarterly results, ratios or fund flow

get_ownership

Shareholding by quarter, with each row's change from the previous quarter

get_operating_metrics

Company-specific KPIs, such as capacity, volumes or deal wins

get_business_mix

Revenue split by product, region or segment, and market shares with their dates

search_screen_fields

Exact screener field names, with units

screen_stocks

Companies matching a financial condition, a business filter or a preset

compare_companies

2 to 6 companies side by side, with growth, 3-year CAGR and peer minimum, median and maximum calculated by tearsheet

get_sector_view

Headline indices, sector indices and conglomerates. Sectors and conglomerates include constituents

search_filings

Pages and figures in your filings that match a query

read_filing

PDF pages, or XBRL figures in crore with their periods

reconcile_figure

One quarterly figure from Tijori beside the filed figure

server_status

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

units

Money is in crore unless a row states otherwise

Row unit

One of crore, crore_shares, percent, days, multiple, rupees_per_share or as_reported. as_reported means the unit is unknown

Period labels

TTM marks trailing twelve months. Interim marks a column whose length Tijori doesn't state

null value

No reliable figure exists. A warning gives the reason

verification.status

matched or mismatch against a filing, otherwise unchecked

warnings

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 login

This 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 NGLFINE/annual-report-2026.pdf

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

TEARSHEET_HOME

~/.tearsheet

session.json and cache.sqlite3, both owner-only

TEARSHEET_FILINGS_DIR

~/.tearsheet/filings

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_CHANGED instead 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

MIT. Credits are in NOTICE.

Available Tools

14 tools
company_snapshotA
Read-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_companiesA
Read-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_companyA
Read-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_mixA
Read-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_financialsA
Read-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_metricsA
Read-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_ownershipA
Read-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_viewA
Read-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_filingA
Read-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_figureA
Read-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_stocksA
Read-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_filingsA
Read-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_fieldsA
Read-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_statusA
Read-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

    A3.9/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides financial data for Indian listed companies from screener.in, enabling users to search companies and fetch financial statements, ratios, and peer comparisons.
      2
      25 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform deep Indian stock research with fundamentals, forensic scores, DCF valuation, screening, and news for 6000+ NSE/BSE stocks.
      19 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      28
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects 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