canli-fundamentals-mcp / Hosted 0.10.0

Company financials as they were known then

What did a company report, and when? Financials from SEC filings as they stood on a date, with later restatements flagged and each value tied to its filing.

Price: $0 to run. Updated 2026-11-08. 8 tools in the hosted release. MIT source. Hosted and npm versions are distributed separately.

When to use this server

Use this server to construct a point-in-time company comparison or inspect how a financial measure changed across filings. Resolve a company by name, ticker or SEC CIK, then ask what had been reported by your decision date. Plain measure names follow the supported XBRL tags; the returned value names the tag actually selected.

Connect the hosted server

Paste this URL into a client that supports MCP over Streamable HTTP:

https://canlicapital.com/mcp/fundamentals

For Claude Code, register the same endpoint:

claude mcp add --transport http canli-fundamentals https://canlicapital.com/mcp/fundamentals

The tool list below describes hosted version 0.10.0. The canli-fundamentals-mcp npm package can have a different version; check its published version and README before using a local install. The developer setup guide covers clients, API keys and local validation.

To run it on your own machine: npx -y canli-fundamentals-mcp. For every Canli Capital server at once: npx -y canli-mcp.

A useful first workflow

  1. Resolve the company and inspect its available concepts. A ticker can change owners; read the resolution metadata before combining records.
  2. Ask known_as_of for a decision date, or history for first-reported, latest or as-of values. Keep period ends, units, filed dates and accession numbers with the values.
  3. Use vintages and restatements to inspect revisions. Use cross_section for up to fifty companies, comparing fiscal period ends before treating them as peers.

Example tool arguments

Read Apple's annual revenue and net income from filings available by the stated decision date. The result describes the retained SEC snapshot; missing periods remain missing.

{
  "name": "known_as_of",
  "arguments": {
    "company": "AAPL",
    "as_of": "2020-12-31",
    "concepts": [
      "revenue",
      "net_income"
    ],
    "periods": "annual"
  }
}

This is a tool name and arguments for your MCP client, not an HTTP request to paste into the endpoint.

Tools in the hosted release

canli-fundamentals-mcp 0.10.0 tool reference
ToolPurpose and input scope
known_as_ofGet what a company had reported as of a date: per measure, the latest period filed by then and its value (changed_after: true adds whether a filing after the date changed it); optionally ratios from those filings. For point-in-time backtests.
historyGet a measure (or several, with concepts) over time, newest first: latest (default), first reported, or as known on a filing date, with its filing, other version and yearly change.
restatementsList periods whose value changed in a later filing, with first and latest values, % change and cause (stock splits left out by default). Omit concept to scan everything.
vintage_diffA company's history as known on two dates: each period whose value changed between them, with the filing that changed it, and how many periods were first reported in between.
vintagesList every filing that reported one period of one measure, oldest first: the revision history behind a number.
list_conceptsList the XBRL concepts a company reports and the plain names it supports, with units, periods, date range and restated-period counts.
find_companyFind a company's SEC CIK and tickers by name, ticker or CIK. The other tools also take a name as company.
cross_sectionGet one measure for up to 50 companies as filed by a date: each one's latest period and its value then (changed_after: true adds whether a filing after the date changed it). For point-in-time peer and factor work.

Questions it has answered

Each page shows the call and the recorded result.

Common questions

Is canli-fundamentals-mcp free?

Yes. It is MIT-licensed and needs no API key and no account.

Why does point-in-time data matter?

A figure can change after it is published. A backtest that reads today's value for an old decision uses a number nobody had then, so this server tells you what was first reported, what the latest filing says, and what was known on a given date.

Where does the data come from?

The SEC's XBRL company facts, with the filing behind each value.

Evidence limits

Coverage is limited to the retained company reference and its SEC snapshots. Filed dates provide filing-date causality, not an intraday information clock. Fiscal calendars differ, later restatements can have several causes, and accounting values are not market prices or strategy returns. The server does not route orders.

Source for this tool list: released commit 583e8ddce24d and the machine-readable discovery record. The page follows the same release pin as the hosted handler. Future package work is described in the repository and is not added here until the hosted release changes.

Continue with the underlying evidence

Compare the finance MCP servers or use the developer API and open repositories.