io.github.mikejj-creation/stocksense
Financial data for AI agents: SEC filings, price history, insider trades, and more.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
stocksenseclaude mcp add stocksense -- uvx stocksense==0.1.1
{
"mcpServers": {
"stocksense": {
"command": "uvx",
"args": [
"stocksense==0.1.1"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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. No API keys needed.
Quick Start
1. Install
pip install stocksense
2. Add to Claude Desktop
Add to your Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"stocksense": {
"command": "stocksense"
}
}
}
3. Restart Claude Desktop
Quit and reopen Claude Desktop. You should see the hammer icon with 13 tools available.
Available Tools
| Tool | Description |
|---|---|
price_history | Get historical OHLCV price data for any ticker |
quote | Get current price, market cap, P/E, 52-week range |
search_filings | Search SEC EDGAR filings (10-K, 10-Q, 8-K) |
get_filing | Get full text of a specific SEC filing |
insider_trades | Get recent insider buys/sells from Form 4 filings |
financials | Get income statement, balance sheet, cash flow, and key ratios |
analyze_company | Comprehensive research brief aggregating all data sources |
compare_companies | Compare key metrics across multiple companies side-by-side |
earnings | Quarterly earnings history with EPS estimates vs actuals |
company_profile | Company profile: sector, industry, and business description |
dividends | Dividend history and current yield |
key_events | Upcoming earnings dates, ex-dividend date, and estimates |
technicals | Technical indicators: SMA, EMA, RSI, MACD, and performance |
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)
Requirements
- Python 3.11+
- No API keys needed — uses free public data sources
Development
# Clone and install for development
git clone https://github.com/mikejj-creation/stocksense.git
cd stocksense
pip install -e ".[dev]"
# Run tests
pytest
# Run linter
ruff check src/ tests/
Disclaimer
StockSense 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.
License
MIT
Questions fréquentes
Qu'est-ce que io.github.mikejj-creation/stocksense ?
Financial data for AI agents: SEC filings, price history, insider trades, and more.
Comment installer io.github.mikejj-creation/stocksense ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add stocksense -- uvx stocksense==0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.mikejj-creation/stocksense ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.mikejj-creation/stocksense est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.mikejj-creation/stocksense ?
Il est publié par mikejj-creation. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.