Quiver Quant

A Model Context Protocol (MCP) server for the Quiver Quantitative alternative-data API, built on FastMCP.

It exposes 16 tools covering congressional trading, SEC Form 4 insider transactions, government contracts, lobbying, r/WallStreetBets activity, off-exchange (dark-pool) short volume, and 13F institutional changes.

⚠️ Not investment advice. Datasets are provided for research and transparency only.

Authentication

Quiver uses a token header: Authorization: Token <YOUR_TOKEN>.

Some live feeds are currently open (work with no token); most datasets require a key:

Tool	Dataset	Token
congress_trading_recent	Live congressional trades (all members)	—
congress_trading_by_ticker	Congressional trades for one ticker	—
insider_trading_recent	Live SEC Form 4 firehose (all tickers)	—
insider_trading_by_ticker	Form 4 for one ticker	✅
gov_contracts_recent / _by_ticker	US government contract awards	✅
lobbying_recent / _by_ticker	Corporate lobbying disclosures	✅
wallstreetbets_recent / _by_ticker	r/WallStreetBets mention activity	✅
offexchange_recent / _by_ticker	Off-exchange / dark-pool short volume	✅
sec13f_changes_recent	Changes in 13F institutional holdings	✅
house_trading_recent	US House trades	✅
senate_trading_recent	US Senate trades	✅
quiver_status	Reports token status + which datasets are open	—

Token-gated tools return a clear "set QUIVER_API_TOKEN" message when no key is configured, so the open datasets remain usable immediately. Get a key at https://www.quiverquant.com/.

Setup

cd quiver-quant-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env        # then edit .env and paste your token

🍏 Apple Silicon note: install with the virtual-env's own pip (as above), not a Rosetta/x86_64 uv, or native wheels (e.g. pydantic-core) can fail to load with an "incompatible architecture" error.

Set your token in .env:

QUIVER_API_TOKEN=your_token_here

It also runs dependency-free via uv thanks to inline PEP 723 metadata:

uv run quiver_quant_mcp.py

Claude Desktop configuration

Add to claude_desktop_config.json, using absolute paths. The server reads the token from its own .env, so the env block can stay empty:

{
  "mcpServers": {
    "quiver-quant": {
      "command": "/absolute/path/to/quiver-quant-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/quiver-quant-mcp/quiver_quant_mcp.py"],
      "env": {}
    }
  }
}

Restart Claude Desktop.

Usage examples

• "What congressional trades came in today?" → congress_trading_recent
• "Show me every congressional trade in NVDA." → congress_trading_by_ticker
• "Any recent insider buying at TSLA?" → insider_trading_by_ticker (needs token)
• "Which companies just won government contracts?" → gov_contracts_recent (needs token)
• "What's trending on WallStreetBets?" → wallstreetbets_recent (needs token)
• "Is my token set up?" → quiver_status

Testing

python test_quiver.py

Offline tests cover the result-trimming helper, auth-header construction (with/without a token), the token-hint messaging, quiver_status, and tool registration. No network needed.

The open endpoints (congress_trading_recent, congress_trading_by_ticker, insider_trading_recent) can be smoke-tested live with no token.

Notes

• limit (1–1000, default 100) trims results client-side; each tool also reports total.
• insider_trading_recent is a large firehose — prefer insider_trading_by_ticker (token) or a small limit for targeted work.
• A few Quiver datasets exposed elsewhere (per-ticker 13F, Wikipedia views, "off the radar" spikes) are intentionally omitted because their API paths could not be confirmed; only verified endpoints are wired up.
• Please respect Quiver Quantitative's API terms and rate limits.

Credits

Data: Quiver Quantitative. This is an independent Python/FastMCP client and is not affiliated with or endorsed by Quiver Quantitative.

License

MIT — see LICENSE if included. Quiver data remains subject to Quiver's terms of use.