StockSense

mcp-name: io.github.mikejj-creation/stocksense

An MCP (Model Context Protocol) server that gives AI agents access to financial data — SEC EDGAR filings, market fundamentals, insider trades, and price history.

Installation

pip install -e .

For development:

pip install -e ".[dev]"

Usage

Run the server

# Either:
stocksense

# Or:
python -m stocksense

Claude Desktop configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "stocksense": {
      "command": "stocksense"
    }
  }
}

Available Tools

Example queries

• "What's AAPL's price history for the last month?"
• "Get me a quote for MSFT"
• "Show me TSLA's weekly prices over the past year"
• "Show me Apple's recent 10-K filings"
• "What insider trades happened at Tesla recently?"
• "Show me Apple's financial statements"
• "Give me a research brief on Tesla"
• "Compare AAPL, MSFT, and GOOGL"
• "Show me Apple's earnings history"
• "What sector is NVIDIA in?"
• "Show me AAPL's dividend history"
• "When is Microsoft's next earnings date?"
• "What are Tesla's technical indicators?"

Data Sources

• yfinance — price data, quotes, financial statements, analyst consensus
• SEC EDGAR — free, unlimited filings and insider trades (no API key needed)

Development

# Run tests
pytest

# Run linter
ruff check src/ tests/

License

MIT