zhensherlock/sp500-mcp-server

View on GitHub ↗

An MCP server and Next.js web app for querying S&P 500 company data from Supabase, with tools for company info, news, officers, and SEC filings, plus embedded MCP App UI resources, Elicitation, and Sampling support.

106 ★1 forksTypeScriptUpdated 2mo ago

What you need to know

An MCP server and Next.js web app for querying S&P 500 company data from Supabase, with tools for fundamentals, financials, prices, news, officers, and SEC filings.

Install

pnpm install, configure Supabase environment variables, build embedded MCP App resources, then pnpm dev

Usage

  • The MCP endpoint runs at http://localhost:3000/sse; query companies through the provided tools in any MCP client.

Key features

  • Company info and annual financials tools
  • Historical daily OHLCV price data
  • Company news with sentiment filtering
  • Officers and SEC filings tools
  • Embedded MCP App UI resources for browsing tools

Best for

Investors and analysts querying S&P 500 data through AI assistants.

Caveats

  • Requires a Supabase project with the S&P 500 data tables; production SSE requires Redis.
Documentation ↗

Reviewed 2026-08-11

Topics

financemcpmcp-appsmcp-servermodel-context-protocolnextjspnpmpnpm-workspacereactsec-filingssp500stockssupabaseturborepotypescript
Stars
106★
Forks
1
Language
TypeScript
License
AGPL-3.0
Created
2026-04-12
Last push
2026-06-11