# Canli Fundamentals

> Canli Fundamentals is an open-source MCP server for finance and payments. Point-in-time SEC fundamentals for AI assistants, with every restatement and its filing. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://canlicapital.com/developers
- **Repository:** https://github.com/arhancanli/canlicapital/tree/HEAD/mcp-fundamentals
- **MCP Registry name:** io.github.arhancanli/canli-fundamentals-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Most financial datasets show only the latest figure for a past period. This server keeps three views of every XBRL value a company reported: what was first reported, what the newest filing says, and what was known on any chosen date. Each value points back to the filing it came from.

The README gives Apple as its example: diluted EPS for fiscal 2018 was 11.91 in the 2018 and 2019 annual reports, then 2.98 after the 4-for-1 split. Of 3,827 annual periods Apple has reported, 190 now read differently from their first report. A backtest that reads today's numbers for a 2018 decision uses data nobody had in 2018, which is the gap the tools are built around.

All eight tools are read-only. The author says the cross-section tool was checked against an independent Python selection over the same SEC snapshots, with 60 of 60 results identical on a 20-company, 3-date test. It runs over stdio from npm or as a hosted Streamable HTTP endpoint, so it suits quant researchers and anyone building factors or peer comparisons on filings.

## Features

- **Known as of a date:** Returns each measure's latest period filed on or before a date, with later restatements flagged.
- **First-reported history:** Shows one measure over time as first reported, latest, or as known on an as-of date.
- **Restatement scan:** Lists periods whose latest value differs from the first report, with a cause such as split or tag change.
- **Vintage comparison:** Compares a company's history on two dates and names the filing behind each change.
- **Peer cross-section:** Reads one measure for up to 50 companies as filed by a date.
- **Hosted or local:** Run with npx, or connect to the hosted Streamable HTTP endpoint.

## Good for

- Build backtests that only use numbers known at the decision date
- Find which of a company's annual figures were later restated
- Compare a metric across up to 50 companies as filed on a date
- Trace every filing that reported a given period's value
- Separate split-driven changes from genuine corrections

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://canlicapital.com/mcp/fundamentals
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "canli-fundamentals-mcp": {
      "url": "https://canlicapital.com/mcp/fundamentals"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "canli-fundamentals-mcp": {
      "type": "http",
      "url": "https://canlicapital.com/mcp/fundamentals"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "canli-fundamentals-mcp": {
      "serverUrl": "https://canlicapital.com/mcp/fundamentals"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "canli-fundamentals-mcp": {
      "type": "http",
      "url": "https://canlicapital.com/mcp/fundamentals"
    }
  }
}
```

## Tools

- `known_as_of`: Most recent period filed on or before a date per measure, flagging later restatements and stale measures.
- `history`: One measure over time: first reported, latest, or as known on an as-of date.
- `restatements`: Periods whose latest value differs from the first report, with cause.
- `vintage_diff`: A company's history as known on two dates, listing changed periods and the changing filing.
- `vintages`: Every filing that reported one period of one measure, oldest first.
- `list_concepts`: Concepts a company reports, with units, period counts and restated-period counts.
- `find_company`: Companies matching a name, ticker or CIK.
- `cross_section`: One measure for up to 50 companies as filed by a date.

## FAQ

### What does 'point in time' mean here?

Each value is available as first reported, as the latest filing states it, and as it stood on a date you choose, with the filing behind it.

### Are the tools read-only?

Yes, all eight tools are read-only.

### How do I install it?

Run npx -y canli-fundamentals-mcp, add it with claude mcp add, or point a client at https://canlicapital.com/mcp/fundamentals.

### Can it flag restated values?

Yes. known_as_of marks values changed later, and restatements lists them with the percent change and a cause.

### Is Canli Fundamentals free?

Yes. Canli Fundamentals is open source, so you can use and self-host it for free.

### How do I add Canli Fundamentals to Claude Code?

Run this command in your terminal: claude mcp add --transport http canli-fundamentals-mcp https://canlicapital.com/mcp/fundamentals

### What are the best alternatives to Canli Fundamentals?

The closest alternatives to Canli Fundamentals are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/canli-fundamentals
