{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zs9r2wx9e4d4","handle":"iflow-mcp-mcp-stockscreen","url":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen","links":{"self":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen/record.json","html":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen","markdown":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-stockscreen","status":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-stockscreen/status","claim":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-mcp-stockscreen/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-stockscreen/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-mcp-stockscreen/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-mcp-stockscreen","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_mcp-stockscreen","summary":"A Model Context Protocol server providing comprehensive stock screening capabilities through Yahoo Finance","description":"# StockScreen MCP Server\n\nA Model Context Protocol (MCP) server providing comprehensive stock screening capabilities through Yahoo Finance. Enables LLMs to screen stocks based on technical, fundamental, and options criteria, with support for watchlist management and result storage.\n\n## Features\n\n### Stock Screening\n- Technical Analysis Screening\n  - Price and volume filters\n  - Moving averages (20, 50, 200 SMA)\n  - RSI indicators\n  - Average True Range (ATR)\n  - Trend analysis (1d, 5d, 20d changes)\n  - MA distance calculations\n\n- Fundamental Screening\n  - Market capitalization filters\n  - P/E ratio analysis\n  - Dividend yield criteria\n  - Revenue growth metrics\n  - ETF-specific metrics (AUM, expense ratio)\n\n- Options Screening\n  - Implied Volatility (IV) filters\n  - Options volume and open interest\n  - Put/Call ratio analysis\n  - Bid-ask spread evaluation\n  - Earnings date proximity checks\n\n### Data Management\n- Watchlist Creation and Management\n- Screening Result Storage\n- Default Symbol Categories\n  - Mega Cap (>$200B)\n  - Large Cap ($10B-$200B)\n  - Mid Cap ($2B-$10B)\n  - Small Cap ($300M-$2B)\n  - Micro Cap (<$300M)\n  - ETFs\n\n## Installation\n\n```bash\n# Install dependencies\npip install -r requirements.txt\n\n# Clone the repository\ngit clone https://github.com/twolven/mcp-stockscreen.git\ncd mcp-stockscreen\n```\n\n## Usage\n\n1. Add to your Claude configuration:\nIn your `claude-desktop-config.json`, add the following to the `mcpServers` section:\n\n```json\n{\n    \"mcpServers\": {\n        \"stockscreen\": {\n            \"command\": \"python\",\n            \"args\": [\"path/to/stockscreen.py\"]\n        }\n    }\n}\n```\n\nReplace \"path/to/stockscreen.py\" with the full path to where you saved the stockscreen.py file.\n\n## Available Tools\n\n## Available Tools\n\n1. `run_stock_screen`\n   \n### Technical Screen Criteria\n```python\n{\n    \"screen_type\": \"technical\",\n    \"criteria\": {\n        \"min_price\": float,              # Minimum stock price\n        \"max_price\": float,              # Maximum stock pr…","publisher":null,"homepage":"https://github.com/iflow-mcp/mcp-stockscreen","repository":"https://github.com/iflow-mcp/mcp-stockscreen","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_mcp-stockscreen","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_mcp-stockscreen","registry":"pypi","observedAt":"2026-09-15T19:23:14.460Z","publishedAt":"2025-11-20T03:10:21.712435Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_mcp-stockscreen","url":"https://pypi.org/project/iflow-mcp_mcp-stockscreen/","firstSeenAt":"2026-09-09T20:23:58.302Z","fetchedAt":"2026-09-15T19:21:33.661Z","normalizedAt":"2026-09-15T19:21:33.661Z"}]},"firstSeenAt":"2026-09-09T20:23:58.302Z","updatedAt":"2026-09-15T19:23:14.460Z"}