English Français العربية

io.github.mikejj-creation/stocksense

السجل الرسمي المالية والمدفوعات

Financial data for AI agents: SEC filings, price history, insider trades, and more.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package stocksense
Claude Code 
claude mcp add stocksense -- uvx stocksense==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "stocksense": {
            "command": "uvx",
            "args": [
                "stocksense==0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. StockSense
  2. Quick Start
  3. Data Sources
  4. Requirements
  5. Development
  6. Disclaimer
  7. License

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
ToolDescription
price_historyGet historical OHLCV price data for any ticker
quoteGet current price, market cap, P/E, 52-week range
search_filingsSearch SEC EDGAR filings (10-K, 10-Q, 8-K)
get_filingGet full text of a specific SEC filing
insider_tradesGet recent insider buys/sells from Form 4 filings
financialsGet income statement, balance sheet, cash flow, and key ratios
analyze_companyComprehensive research brief aggregating all data sources
compare_companiesCompare key metrics across multiple companies side-by-side
earningsQuarterly earnings history with EPS estimates vs actuals
company_profileCompany profile: sector, industry, and business description
dividendsDividend history and current yield
key_eventsUpcoming earnings dates, ex-dividend date, and estimates
technicalsTechnical 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

الأسئلة الشائعة

ما هو io.github.mikejj-creation/stocksense؟

Financial data for AI agents: SEC filings, price history, insider trades, and more.

كيف أثبّت io.github.mikejj-creation/stocksense؟

يعمل على جهازك. في Claude Code: claude mcp add stocksense -- uvx stocksense==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.mikejj-creation/stocksense إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.mikejj-creation/stocksense مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.mikejj-creation/stocksense؟

ينشره mikejj-creation. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.