# Canli Markets

Connects AI coding assistants to primary financial filings, central bank rates and market data without mandatory API keys. Useful for rigorous equity research and fact-checking.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: arhancanli
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/arhancanli/canlicapital/tree/HEAD/mcp-markets
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/canli-markets

## What it does

Requests run locally straight to regulatory archives and monetary authorities, covering EDGAR, ESEF reports, the Federal Reserve, the Bank of England and the ECB. The server attaches the source link and a SHA-256 hash of the received bytes to every output. Anyone can verify the exact document later.

Tooling handles broad US equity scans, table parsing across annual filings and revision tracking between filing versions. Obvious filing typos, such as million-dollar sums mislabeled as billions, get filtered out automatically. The server also pulls overnight policy benchmarks, prediction contracts on Kalshi or Polymarket, and DeFi metrics from DefiLlama.

Regulatory compliance requires setting `SEC_USER_AGENT` with a personal contact email. Without it, EDGAR blocks access. Stock and asset quotes pull keyless price data from Yahoo Finance charts intended for non-commercial use. Users can switch this off with `CANLI_KEYLESS_PRICES=0` and supply custom credentials for Alpaca or Tiingo.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SEC_USER_AGENT`, `ALPACA_API_KEY_ID`, `ALPACA_API_SECRET_KEY`, `TIINGO_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SEC_USER_AGENT=<SEC_USER_AGENT> --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> --transport stdio mcp-markets -- npx -y canli-markets-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-markets --env SEC_USER_AGENT=<SEC_USER_AGENT> --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
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-markets": {
            "command": "npx",
            "args": [
                "-y",
                "canli-markets-mcp"
            ],
            "env": {
                "SEC_USER_AGENT": "<SEC_USER_AGENT>",
                "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
                "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
                "TIINGO_API_KEY": "<TIINGO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-markets": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "canli-markets-mcp"
            ],
            "env": {
                "SEC_USER_AGENT": "<SEC_USER_AGENT>",
                "ALPACA_API_KEY_ID": "<ALPACA_API_KEY_ID>",
                "ALPACA_API_SECRET_KEY": "<ALPACA_API_SECRET_KEY>",
                "TIINGO_API_KEY": "<TIINGO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SEC_USER_AGENT=<SEC_USER_AGENT> -e ALPACA_API_KEY_ID=<ALPACA_API_KEY_ID> -e ALPACA_API_SECRET_KEY=<ALPACA_API_SECRET_KEY> -e TIINGO_API_KEY=<TIINGO_API_KEY> mcp-markets npx -y canli-markets-mcp
```
Replace <…> with your own values

## When to use it
- cross-check financial figures in a drafted report against filed numbers
- trace language updates across consecutive 10-K risk disclosures
- monitor central bank interest rates and overnight funding benchmarks
- pull protocol revenue and total value locked from DeFi platforms
- track event probabilities across Kalshi and Polymarket contracts

## Example prompts
- Check the revenue figures in this paragraph using verify_claims
- Show how the risk factors changed in Apple's latest 10-K filing
- Query prediction market odds for an upcoming interest rate cut

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [arhancanli/canlicapital](https://affpapa.org/en/nevibecode/by/arhancanli/canlicapital.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md