QuarterCharts MCP for Cursor.

30-second setup

1. 1

   Open the Cursor MCP config

   Cursor reads MCP servers from ~/.cursor/mcp.json (or the project-local variant .cursor/mcp.json in your repo root). Create the file if it does not exist. Cline uses the same path convention — these instructions work for both.

2. 2

   Paste the QuarterCharts entry

   The snippet below uses anonymous access — works for every US-listed ticker at the free tier's rate limits (60 req/min). Per-feature paywalls still apply: Pro-only tools (e.g. qc.get_pension_disclosures) require a Pro key. See With an API key below for the authenticated variant.

3. 3

   Reload Cursor

   Restart Cursor (or use the "Reload MCP servers" command in the agent panel). Cursor's MCP indicator should now list quartercharts as a connected server with 11 tools available.

4. 4

   Test it

   In the Cursor chat/agent panel, ask: "What was NVDA's Q4 FY2026 revenue per QuarterCharts?". Cursor routes the call through qc.get_chart and returns $68.127B with citation provenance pointing at the underlying SEC 10-Q filing (us-gaap:Revenues, accession-number embedded).

Config snippet (anonymous)

Paste this into ~/.cursor/mcp.json (create the file if it doesn't exist). Streamable HTTP transport — the modern MCP standard. No API key needed; the free tier handles every US-listed ticker at anonymous rate limits.

{
  "mcpServers": {
    "quartercharts": {
      "transport": "http",
      "url": "https://api.quartercharts.com/mcp"
    }
  }
}

If your Cursor version is older and doesn't accept the transport key, drop it — Cursor will auto-detect from the URL. The example below also works: { "mcpServers": { "quartercharts": { "url": "https://api.quartercharts.com/mcp" } } }

SSE transport (compatibility shim)

The QuarterCharts MCP server primarily speaks Streamable HTTP. If your Cursor build requires the older Server-Sent Events (SSE) transport, use the SSE-compatible URL:

{
  "mcpServers": {
    "quartercharts": {
      "transport": "sse",
      "url": "https://api.quartercharts.com/mcp"
    }
  }
}

Streamable HTTP is recommended (lower latency, no long-poll connection overhead). Use SSE only if your client explicitly errors on the HTTP transport.

With an API key (higher limits + Pro-only tools)

Mint a free key at /dashboard/api-keys and pass it as a Bearer token. Free-tier keys bump the rate limits beyond anonymous and let you call tools that anon clients cannot. Pro keys also unlock the Pro-only tools (pension disclosures, debt schedule, share-count history with split adjustment).

{
  "mcpServers": {
    "quartercharts": {
      "transport": "http",
      "url": "https://api.quartercharts.com/mcp",
      "headers": {
        "Authorization": "Bearer qc_live_your_key_here"
      }
    }
  }
}

Cursor and Cline both forward the headers block verbatim on every request. Treat the key like any other secret — don't commit mcp.json to a public repo with a live key inside.

What Cursor can call

All 11 tools currently shipped on the live MCP surface. Full input schemas at /mcp/tools.

Troubleshooting

Cursor doesn't show "quartercharts" in the connected-servers list.

Restart Cursor fully (quit + reopen, not just reload the window). Some Cursor builds only re-read mcp.json on cold start. Also check the file is valid JSON — a missing comma silently disables every entry.

Tool calls return 429 Too Many Requests.

You've hit the anonymous-tier rate limit (60 req/min). Mint a free key at /dashboard/api-keys and add the headers block from the "With an API key" section above — the rate limit jumps to 300 req/min on free keys.

A Pro-only tool returns 403 Forbidden.

The pension / debt / share-count tools need a Pro-tier key. Free keys still get the 8 core tools. Upgrade self-serve at /pricing — Stripe checkout coming Q2 2026; until then email info@quartercharts.com.

Cursor returns a transport-mismatch error.

Older Cursor builds don't accept the transport key. Drop it and Cursor will auto-detect, or switch to "transport": "sse" if it requires SSE explicitly.