Skip to content
MCP server

Canli Markets

Keyless public market data for AI agents, read straight from SEC, central banks and more

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.17.0
Listing updated
3 days ago

About Canli Markets

Canli Markets is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Instead of reselling a data feed, this server fetches from the primary sources on your own machine and attaches the source URL to each result so an agent can cite it. The README lists SEC EDGAR, the US Treasury, FRED, the World Bank, the New York Fed, the ECB, the Bank of England, the BIS, ESEF reports from European companies, prediction markets and DeFi data, with prices for stocks, currencies, futures, indices and crypto.

Beyond single-company lookups, it has market-wide tools: screen_companies ranks about 3,800 US-listed companies with FY2025 data on revenue, growth, margins, ROE and similar measures, and event_study measures abnormal returns around earnings releases or insider trades with a t test. Another set reads filings the way an analyst would, such as financial statements as filed, the table that holds a given figure, and a results press release set against the later 10-Q or 10-K.

Results carry an evidence list with the SHA-256 of the documents read. Prices default to Yahoo Finance's public chart data, which the README calls unofficial and for personal use; Alpaca or Tiingo keys can replace it. Setting SEC_USER_AGENT to your name and email follows SEC's fair-access policy.

Install

Run in a terminal

claude mcp add canli-markets-mcp --env ALPACA_API_KEY_ID='<ALPACA_API_KEY_ID>' --env ALPACA_API_SECRET_KEY='<ALPACA_API_SECRET_KEY>' --env TIINGO_API_KEY='<TIINGO_API_KEY>' -- npx -y canli-markets-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "canli-markets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canli-markets-mcp"
      ],
      "env": {
        "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
        "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
        "TIINGO_API_KEY": "<TIINGO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "canli-markets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canli-markets-mcp"
      ],
      "env": {
        "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
        "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
        "TIINGO_API_KEY": "<TIINGO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "canli-markets-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "canli-markets-mcp"
      ],
      "env": {
        "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
        "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
        "TIINGO_API_KEY": "<TIINGO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "canli-markets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canli-markets-mcp"
      ],
      "env": {
        "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
        "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
        "TIINGO_API_KEY": "<TIINGO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "canli-markets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canli-markets-mcp"
      ],
      "env": {
        "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
        "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
        "TIINGO_API_KEY": "<TIINGO_API_KEY>"
      }
    }
  }
}

Configuration

  • SEC_USER_AGENTYour name and email for SEC's fair-access policy, e.g. "Jane Doe jane@example.com" (optional).
  • ALPACA_API_KEY_IDAlpaca key id for price_history (optional; paper keys work).
  • ALPACA_API_SECRET_KEYAlpaca secret for price_history (optional).
  • TIINGO_API_KEYTiingo key for price_history if you do not use Alpaca (optional).

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

screen_companies
Rank US-listed companies on revenue, growth, margins, ROE, ROA, free cash flow, R&D intensity or leverage.
company_report
One-call report with five years of financials, valuation, price and risk, insider activity and recent filings.
event_study
Abnormal returns around earnings releases, insider trades or chosen dates.
mentions_trend
How often filings mention a phrase, by month, quarter or year.
financial_statements
Income statement, balance sheet, cash flow and equity statement as filed, several years joined.
filing_tables
Finds the table holding a figure within one or several filings.
earnings_release
A results press release with results and guidance ranges.
release_check
A results release compared against the later 10-Q or 10-K.

What it does

Primary-source reads
Requests go from your machine to SEC, Treasury, FRED, ECB and other sources, each result naming its URL.
Market-wide screening
Ranks US-listed companies on revenue, growth, margins, returns, cash flow or leverage.
Event studies
Measures abnormal returns around earnings releases or insider trades, with a t test.
Filings as filed
Returns statements, filing tables and earnings releases, with restatements beside first-reported figures.
Evidence hashes
Each result lists documents read with the SHA-256 of the bytes received.
Optional price keys
Use Alpaca or Tiingo credentials instead of the keyless Yahoo source.

Good for

  • Rank large companies by R&D intensity or revenue growth
  • Test whether a stock tends to rise after earnings
  • Track how often filings mention a phrase over time
  • Compare a results press release with the filing that followed
  • Pull central-bank rates and macro series with citations

Pricing

Open source

Free, MIT-licensed; optional Alpaca or Tiingo keys use your own account

Prices change. Check canlicapital.com before you buy.

Canli Markets FAQ

Do I need an API key?

No key or account is needed for the default sources. Alpaca and Tiingo keys are optional for prices.

Where do prices come from by default?

From Yahoo Finance's public chart data, which the README describes as unofficial and for personal use under Yahoo's terms.

How is it installed?

Add an mcpServers entry running npx -y canli-markets-mcp.

What should I set for SEC access?

Set SEC_USER_AGENT to your name and email, as SEC's fair-access policy asks.

Is Canli Markets free?

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

How do I add Canli Markets to Claude Code?

Run this command in your terminal: claude mcp add canli-markets-mcp --env ALPACA_API_KEY_ID='<ALPACA_API_KEY_ID>' --env ALPACA_API_SECRET_KEY='<ALPACA_API_SECRET_KEY>' --env TIINGO_API_KEY='<TIINGO_API_KEY>' -- npx -y canli-markets-mcp

What are the best alternatives to Canli Markets?

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

Alternatives to Canli Markets

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments