# mcp

Wires SiftingIO market data into your assistant: live prices, OHLCV bars, SEC fundamentals, 13F holdings and an economic calendar.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: SiftingIO
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SiftingIO/siftingio-mcp
- Updated: 2026-07-11
- HTML: https://affpapa.org/en/nevibecode/mcp/siftingio-mcp

## What it does

The server wraps the `@siftingio/sdk` TypeScript SDK and exposes 36 tools to the model. You get live snapshots (`last_trade`, `last_quote`, `last_tvl`), crypto and forex bars, stock search and profiles, EDGAR documents, institutional ownership, and a macro calendar. List tools accept `cursor`/`limit`; several also take `max_items` to page through results in one call.

Two transports are available: stdio via `npm start`, or Streamable HTTP via `npm run start:http`. The HTTP mode keeps a separate session per client and binds to loopback only, rejecting foreign `Origin` headers. Set the port with `PORT` or `MCP_HTTP_PORT`; it defaults to 3000. To reach it from outside, set `MCP_AUTH_TOKEN` and every request must carry `Authorization: Bearer`.

Without `SIFTING_API_KEY` the server will not start — keys come from sifting.io. Backend addresses can be overridden with `SIFTING_BASE_URL` and `SIFTING_WS_URL`. Streaming runs over one persistent WebSocket with a buffer: subscribe and poll (`ws_subscribe`, `ws_poll`) for ongoing feeds, or `ws_collect` for a short one-shot grab. Responses are capped near 60k characters; when a heavy endpoint exceeds that, the server trims the largest array and adds a `_truncated` note telling you how to narrow the query.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SIFTING_API_KEY`, `SIFTING_BASE_URL`, `SIFTING_WS_URL` — 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 SIFTING_API_KEY=<SIFTING_API_KEY> --env SIFTING_BASE_URL=<SIFTING_BASE_URL> --env SIFTING_WS_URL=<SIFTING_WS_URL> --transport stdio siftingio-mcp -- npx -y siftingio-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add siftingio-mcp --env SIFTING_API_KEY=<SIFTING_API_KEY> --env SIFTING_BASE_URL=<SIFTING_BASE_URL> --env SIFTING_WS_URL=<SIFTING_WS_URL> -- npx -y siftingio-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "siftingio-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "siftingio-mcp"
            ],
            "env": {
                "SIFTING_API_KEY": "<SIFTING_API_KEY>",
                "SIFTING_BASE_URL": "<SIFTING_BASE_URL>",
                "SIFTING_WS_URL": "<SIFTING_WS_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "siftingio-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "siftingio-mcp"
            ],
            "env": {
                "SIFTING_API_KEY": "<SIFTING_API_KEY>",
                "SIFTING_BASE_URL": "<SIFTING_BASE_URL>",
                "SIFTING_WS_URL": "<SIFTING_WS_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SIFTING_API_KEY=<SIFTING_API_KEY> -e SIFTING_BASE_URL=<SIFTING_BASE_URL> -e SIFTING_WS_URL=<SIFTING_WS_URL> siftingio-mcp npx -y siftingio-mcp
```
Replace <…> with your own values

## When to use it
- pull the latest price for a ticker before a calculation
- fetch OHLCV bars for a chosen interval
- find a company's filings in EDGAR and read the sections
- check which funds hold a stock according to 13F
- catch the release time of a macro statistic

## Example prompts
- Show me the last trade on BTCUSD and the hourly bars
- Find NVDA's latest quarterly filing in EDGAR and list the risk factors
- Subscribe to the DEX trades feed and collect a few seconds of data

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

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

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