Skip to main content
Glama
Snapstock MCP Server

Snapstock MCP Server

by sorndotdev

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

Claude 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.js

Official 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

get_ticker_score

0-10 safety score, label, five component scores, streak, yield, and links for one ticker.

get_red_flags

Red-flag list, five- and ten-year dividend-decline flags, and earnings/FCF payout ratios.

get_dividend_history

Annual dividends per share, year-over-year changes, current yield, streak, and next ex-date.

search_tickers

Search by ticker, company name, sector, and score range. Up to 100 results.

list_below_threshold

Tickers scoring below a threshold, sorted weakest first. Default threshold: 4.

get_dataset_info

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

data/dividend-safety.csv

SHA-256

41f949b8b4ea03d2e3c48a1d9c28f8496033f6d6d746bd837e8d544c05c3b1f5

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

Development

npm install
npm test        # builds and runs an end-to-end smoke test over stdio
npm start       # runs the server on stdio

The 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 tools
get_dataset_infoGet dataset metadataA
Read-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 historyA
Read-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 flagsB
Read-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 scoreA
Read-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 scoreA
Read-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 payersA
Read-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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tool names use consistent snake_case with a leading verb (get_, search_, list_). The pattern is predictable across all six tools.

    Tool Count5/5

    Six tools is well-scoped for a read-only dividend-safety dataset. Each tool covers a distinct research operation without bloat.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to access stock prices, financial statements, earnings call transcripts, and fundamental data for 60,000+ public companies via 25 read-only tools.
      25
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      -