# Canli Markets

> Canli Markets is an open-source MCP server for finance and payments. Keyless public market data for AI agents, read straight from SEC, central banks and more. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [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-markets
