StockSense

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

PyPI version PyPI downloads Python versions License: MIT

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

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)

Development

# Run tests
pytest

# Run linter
ruff check src/ tests/

License

MIT

Project links

Data verified by PyPI on Apr 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mikejj from gravatar.com mikejj

GitHub Statistics

Data verified by PyPI on Apr 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp finance sec edgar stocks ai llm stocksense

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stocksense-0.1.1.tar.gz (28.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stocksense-0.1.1-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

Details for the file stocksense-0.1.1.tar.gz.

File metadata

  • Download URL: stocksense-0.1.1.tar.gz
  • Upload date:
  • Size: 28.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for stocksense-0.1.1.tar.gz
Algorithm Hash digest
SHA256 13c0af1a09cb8de0416ebb28e949517131c92033a8f6a76317930580a13803d1
MD5 5a9f9f47532838daef264aad256a2299
BLAKE2b-256 5b9c79467d23471e1396630f1b27c93d740267d42fe9573d62ad7511a3718414

See more details on using hashes here.

Provenance

The following attestation bundles were made for stocksense-0.1.1.tar.gz:

Publisher: publish.yml on mikejj-creation/stocksense

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file stocksense-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: stocksense-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 22.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for stocksense-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3ae7f37b36997a9fe056e32e31038a07da1e456fc4794e7effefeb0e03a98895
MD5 a94e14346c625973007f3eccdbcf1603
BLAKE2b-256 54e39ed29c05de48a66f35fd415bb0e10fb43a5fd06e9b70e925bdd67c3f8950

See more details on using hashes here.

Provenance

The following attestation bundles were made for stocksense-0.1.1-py3-none-any.whl:

Publisher: publish.yml on mikejj-creation/stocksense

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page