io.github.Stewyboy1990/stockscope-mcp

Official

by Stewyboy1990 · JavaScript

SEC EDGAR financial data for AI agents — revenue, margins, filings, company comparisons.

Accesses SEC EDGAR financial data including revenue, margins, filings, and company comparisons.

Topics

ai-agentai-toolsfinancefinancial-datainvestment-researchmcpmcp-servermodel-context-protocolsec-edgarsec-filingsstockstock-research

README.md2 KBView on GitHub

StockScope MCP

Stock & financial intelligence MCP server powered by SEC EDGAR. Free, no API key required.

Tools

Tool	Description
`stock_financials`	Revenue, net income, assets, liabilities, equity, margins from SEC XBRL data
`stock_filings`	Recent 10-K, 10-Q, 8-K filings with dates, links, descriptions
`stock_compare`	Side-by-side financial comparison of two companies
`stock_insiders`	Recent insider transactions (buys/sells) from SEC filings
`stock_history`	Historical stock price data (open, high, low, close, volume)
`stock_sector_peers`	Find companies in the same SIC sector with key metrics

All data sourced from SEC EDGAR public APIs. Zero cost, no API keys.

Quick Start

Claude Desktop / Cursor

Add to your MCP config:

json

{
  "mcpServers": {
    "stockscope": {
      "command": "npx",
      "args": ["-y", "stockscope-mcp"]
    }
  }
}

Remote (Cloudflare Workers)

Connect directly via MCP endpoint:

code

https://stockscope-mcp.stewwilli.workers.dev/mcp

Apify

Available as an Apify Actor for batch processing:

code

https://apify.com/constructive_wainscot/stockscope-mcp

Example

Ask your AI assistant:

"Get Apple's financials from the last 3 years"
"Compare Tesla and Ford's financial performance"
"Show me recent insider transactions for NVDA"
"What 10-K filings has Microsoft submitted recently?"
"Find companies in Apple's sector"

How It Works

StockScope fetches structured financial data directly from SEC EDGAR's public XBRL API. No scraping, no paid data providers. The EDGAR API is free, reliable, and covers all US public companies.

Data sources:

SEC EDGAR XBRL API (financials, filings)
SEC EDGAR full-text search (filings)
SEC insider transaction filings (Form 4)
SEC company tickers database (sector peers)

Pricing (Apify Store)

Event	Price
`stock-financials`	$0.10
`stock-filings`	$0.05
`stock-compare`	$0.15
`stock-insiders`	$0.05
`stock-history`	$0.08
`stock-sector-peers`	$0.08

Free via npm/npx. Apify pricing applies only to Apify Store runs.

CompanyScope MCP - Company research & lead enrichment (11 tools, 12 data sources). Also on Apify Store and npm.

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "stockscope-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stockscope-mcp@1.1.0"
      ]
    }
  }
}