canli-mcp / Beating guidance

How often does a company beat its own guidance?

Over 11 guided quarters, NVIDIA's revenue came in above its own range every time. canli-mcp's guidance_record sets each quarter's guidance against what followed, from the company's own press releases, free with no key. A company that nearly always beats may simply set its range low.

Add to CursorAdd to VS Code

Price: $0 to run. Updated 2026-11-02. Free and MIT-licensed, with no account and no API key. Or run claude mcp add canli -- npx -y canli-mcp in Claude Code.

Ask it

How often has NVIDIA beaten its own guidance?

The agent finds the tool through canli-mcp's find_tool and runs it through run_tool. This is the call:

{
  "name": "guidance_record",
  "arguments": {
    "company": "NVDA",
    "quarters": 12
  }
}

What came back

Recorded from canli-mcp 0.16.1 on 2026-11-02, with no API key set. The model read 5,588 characters.

What guidance_record returned, the first rows; the first columns
quarterfiledmeasurebasisunitguided lowguided highactual
Q2 20272026-08-26revenueUSD billion89.1892.8296.2
Q2 20272026-08-26gross_marginGAAP%74.475.475
Q2 20272026-08-26gross_marginnon-GAAP%74.575.575
Q1 20272026-05-20revenueUSD billion76.4479.5681.6
Q1 20272026-05-20gross_marginGAAP%74.475.474.9
Q1 20272026-05-20gross_marginnon-GAAP%74.575.575
Q4 20262026-02-25revenueUSD billion63.766.368.1
Q4 20262026-02-25gross_marginGAAP%74.375.375
The result guidance_record sent back, in full form
{
  "ref": "r1",
  "company": "NVIDIA CORP",
  "releases_read": 12,
  "from": "2023-11-21",
  "to": "2026-08-26",
  "guided_lines_matched": 24,
  "reading": "Over 11 guided quarters, NVIDIA CORP's revenue came in above its own range 11 times, within it 0 and below it 0. A company that nearly alway…",
  "record": {
    "columns": [
      "measure",
      "basis",
      "unit",
      "times",
      "above_range",
      "within_range",
      "…"
    ],
    "rows": [
      [
        "revenue",
        null,
        "USD billion",
        11,
        11,
        0,
        "…"
      ],
      [
        "gross_margin",
        "GAAP",
        "%",
        6,
        1,
        4,
        "…"
      ],
      [
        "gross_margin",
        "non-GAAP",
        "%",
        6,
        1,
        4,
        "…"
      ]
    ]
  },
  "columns": [
    "quarter",
    "filed",
    "measure",
    "basis",
    "unit",
    "guided_low",
    "…"
  ],
  "rows": [
    [
      "Q2 2027",
      "2026-08-26",
      "revenue",
      null,
      "USD billion",
      89.18,
      "…"
    ],
    [
      "Q2 2027",
      "2026-08-26",
      "gross_margin",
      "GAAP",
      "%",
      74.4,
      "…"
    ],
    [
      "Q2 2027",
      "2026-08-26",
      "gross_margin",
      "non-GAAP",
      "%",
      74.5,
      "…"
    ],
    [
      "Q1 2027",
      "2026-05-20",
      "revenue",
      null,
      "USD billion",
      76.44,
      "…"
    ],
    [
      "Q1 2027",
      "2026-05-20",
      "gross_margin",
      "GAAP",
      "%",
      74.4,
      "…"
    ],
    [
      "Q1 2027",
      "2026-05-20",
      "gross_margin",
      "non-GAAP",
      "%",
      74.5,
      "…"
    ],
    "…"
  ],
  "meaning": "Each line sets what a company's earlier release guided against what its next release reported, as both are worded. Lines match by measure, b…",
  "sources": [
    "The company's results press releases, filed on Form 8-K"
  ],
  "limits": [
    "Only guidance given in the press release itself. Many companies, Apple among them, give it on the call or not at all, and those show nothing…",
    "A record of what was said and what came, read from text by rules, so check the quotes in earnings_release before relying on one line. It doe…"
  ]
}

Prices, filings and statistics are as the sources published them on that day; run the call again for today's. Nothing here is investment advice.

The tools behind the answer

From canli-mcp's tool index
ToolPackWhat it does
guidance_recordmarketsA management team's record against its own word: each quarter it gave guidance in its press release, what it said and what then happened, how often results came in above, within and below its own range, and which quarters fell short.

Add canli-mcp

Claude Code
claude mcp add canli -- npx -y canli-mcp
Cursor, Claude Desktop or any MCP client
{ "mcpServers": { "canli": { "command": "npx", "args": ["-y", "canli-mcp"] } } }
claude.ai, ChatGPT or any client that takes a URL
https://canlicapital.com/mcp/canli

Everything canli-mcp does · How it compares with other finance MCP servers

Related questions