# 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](https://www.sec.gov/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:

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

### Apify

Available as an Apify Actor for batch processing:

```
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.

## Related

- [CompanyScope MCP](https://github.com/Stewyboy1990/companyscope-mcp) - Company research & lead enrichment (11 tools, 12 data sources). Also on [Apify Store](https://apify.com/constructive_wainscot/companyscope-mcp) and [npm](https://www.npmjs.com/package/companyscope-mcp).

## License

MIT