MCP Catalogs
← Home

sp500-mcp-server

by zhensherlock·★ 96·Score 47

A well-documented MCP server providing S&P 500 company data tools through a Next.js web interface with Supabase backend.

financedeveloper-toolsai-llm
1
Forks
1
Open issues
this month
Last commit
2d ago
Indexed

Overview

The sp500-mcp-server is a comprehensive implementation of the Model Context Protocol that exposes tools for querying S&P 500 company information from a Supabase database. It offers six primary tools for accessing company basics, financial metrics, historical price data, news sentiment, executive officers, and SEC filings. The server includes both MCP protocol endpoints and a Next.js web application for direct interaction, with embedded MCP App UI resources. The project uses modern technologies including Node.js 22, Next.js 16, React 19, and TypeScript with strict mode, all managed via Turborepo.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Financial analysts researching S&P 500 companies through AI assistants with direct data access
you:Investment portfolio tools requiring real-time company financials and news data
you:Academic researchers studying market trends using standardized S&P 500 metrics
you:What is the endpoint for the MCP server?
you:Can I use this without a Supabase database?

When to choose this

Choose this MCP server if you need access to S&P 500 company data for financial analysis or AI applications, especially if you're already using or comfortable with Supabase as a data source.

When NOT to choose this

Don't choose this if you need data outside of S&P 500 companies, require real-time market data feeds, or prefer a self-hosted solution without Supabase dependencies.

Tools this server exposes

6 tools extracted from the README
  • get_company_info

    Company basics, financials, leadership, address, and business summary

  • get_company_financials

    Annual financial metrics with chart-ready trends and matrix output

  • get_company_price_data

    Historical daily OHLCV price rows with date filters

  • get_company_news

    Recent company news with sentiment filtering

  • get_company_officers

    Executive officers and compensation

  • get_company_filings

    SEC filings history, with filing type and date filters

Comparable tools

financial-data-mcpmarket-data-apipolygon-mcpyfinance-mcp

Installation

  1. Install dependencies: pnpm install
  2. Create local env file with Supabase credentials (SUPABASE_URL and SUPABASE_ANON_KEY required)
  3. Build embedded MCP App HTML resources: pnpm --filter @apps/web-app build
  4. Start apps: pnpm dev

For Claude Desktop, add to config.json:

{
  "mcpServers": {
    "sp500": {
      "command": "npx",
      "args": ["@your-org/sp500-mcp-server"],
      "env": {
        "SUPABASE_URL": "your_url",
        "SUPABASE_ANON_KEY": "your_key"
      }
    }
  }
}

FAQ

What is the endpoint for the MCP server?
The MCP endpoint is http://localhost:3000/sse when running locally.
Can I use this without a Supabase database?
No, the server requires a Supabase project with S&P 500 data tables to function properly.

Compare sp500-mcp-server with

sp500-mcp-server vs ultimate_mcp_serversp500-mcp-server vs mcp-server-chartsp500-mcp-server vs everythingsp500-mcp-server vs filesystemsp500-mcp-server vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.