{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rtn3gg8xx248","handle":"mcp-stockscreen","url":"https://wellknown.network/agents/mcp-stockscreen","links":{"self":"https://wellknown.network/agents/mcp-stockscreen/record.json","html":"https://wellknown.network/agents/mcp-stockscreen","markdown":"https://wellknown.network/agents/mcp-stockscreen/record.md","api":"https://wellknown.network/api/v1/agents/mcp-stockscreen","status":"https://wellknown.network/api/v1/agents/mcp-stockscreen/status","claim":"https://wellknown.network/agents/mcp-stockscreen/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-stockscreen/claim.json","badge":"https://wellknown.network/agents/mcp-stockscreen/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-stockscreen/history","tools":"https://wellknown.network/api/v1/agents/mcp-stockscreen/tools"},"ard":{"identifier":"urn:air::server:mcp-stockscreen","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-stockscreen","summary":"MCP server for stock screening — technical, fundamental, options, news screening, watchlists and dividend rankings","description":"# StockScreen MCP Server\n\n> **Fork notice**: This project is a heavily modified fork of [twolven/mcp-stockscreen](https://github.com/twolven/mcp-stockscreen). Major additions include Boursorama & Euronext providers, multi-transport support (SSE/Streamable HTTP), dividend palmarès, watchlist management, and comprehensive test coverage.\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for stock screening. Expose six tools to any MCP-compatible client (Claude Code, Claude Desktop…) to screen stocks on technical, fundamental, options, and news criteria, manage watchlists, retrieve dividend rankings, and persist results.\n\n**Data sources**\n- **Yahoo Finance** (`YahooProvider`) — primary source for price, volume, RSI, P/E, options chains, and news. Covers US and international equities and ETFs.\n- **Boursorama** (`BoursoramaProvider`) — supplementary provider for Euronext Paris data (cours, dividende, rendement, consensus analystes, historique CA/RN). Integrated transparently via `MarketDataFacade`.\n- **Euronext** (`EuronextProvider`) — bidirectional ISIN ↔ ticker resolution. Converts ISIN identifiers to Yahoo-compatible tickers (e.g. `FR0000131104` → `TTE.PA`).\n- **Boursorama Palmares** (`BoursoramaPalmaresScaper`) — scrapes the full multi-page Boursorama dividend ranking table (palmarès dividendes Euronext Paris).\n\n---\n\n## Features\n\n| Category | Criteria |\n|---|---|\n| **Technical** | Price, volume, RSI(14), SMA 20/50/200, ATR%, trend changes |\n| **Fundamental** | Market cap, P/E, dividend yield, revenue growth, ETF metrics (AUM, expense ratio) |\n| **Options** | IV, option volume, put/call ratio, bid-ask spread, days-to-earnings |\n| **News** | Keyword matching, management changes, date range |\n| **Custom** | Combine any of the above — short-circuits on first rejection |\n| **Dividend palmares** | Boursorama top-yield ranking with multi-year dividend history, filterable by yield and name |\n\n---\n\n## Installation\n\n**Only prerequisite**: [uv](https://docs.as…","publisher":null,"homepage":"https://github.com/cyberbobjr/mcp-stockscreen","repository":"https://github.com/cyberbobjr/mcp-stockscreen","version":"2.1.1","license":"MIT","protocols":["mcp"],"tags":["boursorama","dividend","euronext","finance","mcp","screening","stocks","yahoo-finance"],"pricing":null,"endpoints":[{"url":"pypi: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":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["finance"],"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":"mcp-stockscreen","registry":"pypi","observedAt":"2026-11-03T16:26:01.950Z","publishedAt":"2026-05-06T16:37:17.562439Z","latestVersion":"2.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-stockscreen","url":"https://pypi.org/project/mcp-stockscreen/","firstSeenAt":"2026-09-10T04:23:26.011Z","fetchedAt":"2026-11-03T16:24:35.409Z","normalizedAt":"2026-11-03T16:24:35.409Z"}]},"firstSeenAt":"2026-09-10T04:23:26.011Z","updatedAt":"2026-11-03T16:26:01.950Z"}