Snapstock MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Snapstock MCP Server What's the dividend safety score for Realty Income?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Snapstock MCP Server
A read-only, keyless Model Context Protocol server for Snapstock's free dividend safety dataset.
Snapstock publishes 0-10 dividend safety scores, red flags, payout ratios, dividend streaks, and annual dividend history for 1,912 US-listed dividend payers. This server bundles a dated CSV snapshot and exposes it as six tools for Claude, Cursor, and other MCP clients. Tool calls run locally and make no network requests.
No API key.
No backend. The data ships with the server.
Read-only. Six tools, no writes, no account.
Free data. The snapshot is published under CC BY 4.0.
Quick start
Claude Code
claude mcp add snapstock -- npx -y github:sorndotdev/snapstock-mcpClaude Desktop / Cursor
Add this to your MCP configuration (claude_desktop_config.json or .cursor/mcp.json):
{
"mcpServers": {
"snapstock": {
"command": "npx",
"args": ["-y", "github:sorndotdev/snapstock-mcp"]
}
}
}Node.js 18 or newer is required. The first launch downloads the package from GitHub; after that, the bundled snapshot is used offline.
From a clone
git clone https://github.com/sorndotdev/snapstock-mcp.git
cd snapstock-mcp
npm install
npm run build
node dist/index.jsOfficial MCP Registry
The server is listed as io.github.sorndotdev/snapstock-mcp in the Official MCP Registry.
An MCPB bundle is attached to the v0.1.0 release,
so registry-aware clients can install it without npm.
Related MCP server: Stock Research Data Foundation MCP Server
Tools
Tool | What it returns |
| 0-10 safety score, label, five component scores, streak, yield, and links for one ticker. |
| Red-flag list, five- and ten-year dividend-decline flags, and earnings/FCF payout ratios. |
| Annual dividends per share, year-over-year changes, current yield, streak, and next ex-date. |
| Search by ticker, company name, sector, and score range. Up to 100 results. |
| Tickers scoring below a threshold, sorted weakest first. Default threshold: 4. |
| Coverage counts, data date, snapshot checksum, license, citation, and source links. |
Example prompts:
"What is Snapstock's dividend safety score for Realty Income?"
"Show me the red flags and payout ratios for MO."
"Find utilities scoring above 7 with a yield above 4%."
"List ETFs scoring below 4 and summarize the common red flags."
Data snapshot
Field | Value |
Data date | 2026-11-15 |
Tickers | 1,912 (1,901 scored) |
Below 4.0 | 451 |
FCF payout above 100% | 92 |
Five-year dividend-decline flags | 192 |
Ten-year dividend-decline flags | 202 |
Bundled file |
|
SHA-256 |
|
Source page and corrections log: https://learn.snapstock.app/data/dividend-safety/#corrections
Bulk CSV: https://learn.snapstock.app/data/dividend-safety.csv
Per-ticker JSON:
https://learn.snapstock.app/stocks/{TICKER}/facts.json
The snapshot is static. The live site may be newer. To bundle a newer snapshot, replace
data/dividend-safety.csv, update the date, counts, and checksum in this README, then run
npm test. The server computes coverage counts from the CSV at load time.
Attribution
Data: Snapstock, Snapstock Dividend Safety Index, data as of 2026-11-15, https://learn.snapstock.app/data/dividend-safety/. Licensed under CC BY 4.0.
Every tool response includes the data date, source URL, license, and a ready-to-use citation.
License
Code: MIT. See LICENSE.
Bundled data: CC BY 4.0. See DATA-LICENSE.md.
Development
npm install
npm test # builds and runs an end-to-end smoke test over stdio
npm start # runs the server on stdioThe smoke test starts the built server, lists tools, and calls each one. It checks the published coverage counts and the error path for an unknown ticker.
Disclaimer
Snapstock scores and red flags are research aids. They are not investment advice, predictions, or guarantees against a dividend cut. Data is delayed and may contain errors. Do not present tool output as investment advice.
About
Built and maintained by the Snapstock team. The free learn site is https://learn.snapstock.app/; the Snapstock app is https://snapstock.app/.
Available Tools
6 toolsget_dataset_infoGet dataset metadataARead-only
Describe the bundled Snapstock snapshot: coverage counts, data date, license, source and changelog URL, and how to cite it. Use this before citing any figure.
Inputs: no named parameters.
get_dividend_historyGet annual dividend historyARead-only
Get annual dividends per share, year-over-year changes, current yield, streak, and the next ex-date for one ticker. Annual totals include special dividends. Dataset snapshot: 2026-11-15.
Inputs: ticker (required).
get_red_flagsGet dividend red flagsBRead-only
List Snapstock's red flags for one ticker, including explicit five- and ten-year dividend-decline flags, earnings and free-cash-flow payout ratios, and the current score. Research aid, not investment advice. Dataset snapshot: 2026-11-15.
Inputs: ticker (required).
get_ticker_scoreGet dividend safety scoreARead-only
Get Snapstock's 0-10 dividend safety score, label, five component scores, streak, and yield for one US-listed dividend payer. The score is a research aid, not investment advice. Dataset snapshot: 2026-11-15 (CC BY 4.0).
Inputs: ticker (required).
list_below_thresholdList tickers below a scoreARead-only
List dividend payers scoring below a safety-score threshold, sorted from weakest upward. Useful for screening for elevated dividend-cut risk. Dataset snapshot: 2026-11-15.
Inputs: limit, sector, maxScore.
search_tickersSearch dividend payersARead-only
Search or screen the Snapstock dataset by ticker, company name, sector, score range, and minimum yield. Returns up to 100 matches with score, yield, streak, and red-flag count. Dataset snapshot: 2026-11-15.
Inputs: limit, query, sector, maxScore, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear primary purpose: score, red flags, dividend history, search, below-threshold screening, and dataset metadata. There is some overlap because get_ticker_score and get_red_flags both include the safety score, and search_tickers can filter by score range while list_below_threshold is a specialized screen.
All tool names use consistent snake_case with a leading verb (get_, search_, list_). The pattern is predictable across all six tools.
Six tools is well-scoped for a read-only dividend-safety dataset. Each tool covers a distinct research operation without bloat.
The surface covers the full lifecycle of the bundled dataset: ticker lookup, safety scoring, red-flag diagnostics, dividend history, screening/search, threshold lists, and dataset metadata. No create/update operations are needed for a static snapshot.
Maintenance
Related MCP Connectors
SEC filings — 13F, Form 4, 8-K, 13D, IPO and short-interest data — as 17 agent tools.
Free U.S. dividend data: yields, ex-dates, raises and cuts, safety grades, option-income ETFs.
SEC EDGAR fundamentals as agent tools: look up or screen US public companies. Free, no key, CC0.
Read-only US stock research: scores with their math, statements, ratios and playbooks, all dated.
Related MCP Servers
AlicenseAqualityCmaintenanceEnables AI assistants to access stock prices, financial statements, earnings call transcripts, and fundamental data for 60,000+ public companies via 25 read-only tools.254MIT- AlicenseNot gradedqualityDmaintenanceProvides 11 tools for stock research, including search, market history, financial statements, announcements, and data quality checks, with a local-first architecture using DuckDB and Parquet.MIT
- FlicenseNot gradedqualityDmaintenanceEnables RAG-based querying of local stock company data using a local LLM and vector database, providing tools to ask questions, search raw chunks, and list documents.-
- FlicenseNot gradedqualityCmaintenanceEnables financial research agents to query a read-only SQLite snapshot through six predefined, validated, sector-scoped tools for company snapshots, metric comparisons, sector benchmarks, and qualitative evidence search, returning sources, data dates, confidence, and limitations.-