{
  "markdown": "# StockSense\n\n<!-- mcp-name: io.github.mikejj-creation/stocksense -->\n\n[![PyPI version](https://img.shields.io/pypi/v/stocksense)](https://pypi.org/project/stocksense/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/stocksense)](https://pypi.org/project/stocksense/)\n[![Python versions](https://img.shields.io/pypi/pyversions/stocksense)](https://pypi.org/project/stocksense/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nAn MCP (Model Context Protocol) server that gives AI agents access to financial data — SEC EDGAR filings, market fundamentals, insider trades, and price history. No API keys needed.\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install stocksense\n```\n\n### 2. Add to Claude Desktop\n\nAdd to your Claude Desktop config:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"stocksense\": {\n      \"command\": \"stocksense\"\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\nQuit and reopen Claude Desktop. You should see the hammer icon with 13 tools available.\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `price_history` | Get historical OHLCV price data for any ticker |\n| `quote` | Get current price, market cap, P/E, 52-week range |\n| `search_filings` | Search SEC EDGAR filings (10-K, 10-Q, 8-K) |\n| `get_filing` | Get full text of a specific SEC filing |\n| `insider_trades` | Get recent insider buys/sells from Form 4 filings |\n| `financials` | Get income statement, balance sheet, cash flow, and key ratios |\n| `analyze_company` | Comprehensive research brief aggregating all data sources |\n| `compare_companies` | Compare key metrics across multiple companies side-by-side |\n| `earnings` | Quarterly earnings history with EPS estimates vs actuals |\n| `company_profile` | Company profile: sector, industry, and business description |\n| `dividends` | Dividend history and current yield |\n| `key_events` | Upcoming earnings dates, ex-dividend date, and estimates |\n| `technicals` | Technical indicators: SMA, EMA, RSI, MACD, and performance |\n\n### Example queries\n\n- \"What's AAPL's price history for the last month?\"\n- \"Get me a quote for MSFT\"\n- \"Show me TSLA's weekly prices over the past year\"\n- \"Show me Apple's recent 10-K filings\"\n- \"What insider trades happened at Tesla recently?\"\n- \"Show me Apple's financial statements\"\n- \"Give me a research brief on Tesla\"\n- \"Compare AAPL, MSFT, and GOOGL\"\n- \"Show me Apple's earnings history\"\n- \"What sector is NVIDIA in?\"\n- \"Show me AAPL's dividend history\"\n- \"When is Microsoft's next earnings date?\"\n- \"What are Tesla's technical indicators?\"\n\n## Data Sources\n\n- **yfinance** — price data, quotes, financial statements, analyst consensus\n- **SEC EDGAR** — free, unlimited filings and insider trades (no API key needed)\n\n## Requirements\n\n- Python 3.11+\n- No API keys needed — uses free public data sources\n\n## Development\n\n```bash\n# Clone and install for development\ngit clone https://github.com/mikejj-creation/stocksense.git\ncd stocksense\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Run linter\nruff check src/ tests/\n```\n\n## Disclaimer\n\nStockSense uses free public data from Yahoo Finance and SEC EDGAR. Users are responsible for complying with each provider's terms of service. This tool is for informational purposes only — not financial advice.\n\n## License\n\nMIT\n",
  "bytes": 3414,
  "sha": "cb4d5b3704f487f8e5eb02e233d536d9861ed40ae9e926d2325ebffe05423523",
  "repo_slug": "mikejj-creation/stocksense",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mikejj_creation_stocksense_6da1df53/readme"
}