{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xrvrmx5rmm8b","handle":"yfinance-mcp-server","url":"https://wellknown.network/agents/yfinance-mcp-server","links":{"self":"https://wellknown.network/agents/yfinance-mcp-server/record.json","html":"https://wellknown.network/agents/yfinance-mcp-server","markdown":"https://wellknown.network/agents/yfinance-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/yfinance-mcp-server","status":"https://wellknown.network/api/v1/agents/yfinance-mcp-server/status","claim":"https://wellknown.network/agents/yfinance-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yfinance-mcp-server/claim.json","badge":"https://wellknown.network/agents/yfinance-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yfinance-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yfinance-mcp-server","summary":"A comprehensive yfinance MCP server providing access to Yahoo Finance data","description":"# YFinance MCP Server\n\nA fully-featured **Model Context Protocol (MCP)** server that exposes nearly all of Yahoo Finance’s capabilities through simple, typed MCP tools.  \nBuilt with [FastMCP](https://gofastmcp.com) so you can plug it straight into any LLM workflow, agent framework, or the official MCP client SDK.\n\n---\n\n## Features\n\n* 25+ tools covering:\n  * Price history (single & multiple tickers)\n  * Financial statements (income, balance sheet, cash-flow)\n  * Analyst data (recommendations, price targets, earnings estimates)\n  * Ownership & insider transactions\n  * Dividends, splits & actions\n  * Options chains\n  * News & earnings calendar\n  * Fund / ETF holdings\n  * ESG & sustainability metrics\n  * Stock screeners & search utilities\n  * Batch operations & yfinance global configuration\n* Pure-Python, zero external services required.\n* Exposes both **STDIO** (default) and **HTTP/SSE** transports if you want to serve over the network.\n\n---\n\n## Requirements\n\n* Python 3.10+\n* **pipx** (for MCP client integration)\n\nAll dependencies are listed in `requirements.txt` (generated below).\n\n```\npandas\nyfinance\nfastmcp\n```\n\n> If you already installed packages manually you can skip the next step.\n\n### Installing pipx\n\nIf you don't have pipx installed, install it first:\n\n**macOS:**\n```bash\nbrew install pipx\n```\n\n**Linux/Ubuntu:**\n```bash\nsudo apt install pipx\n# or\npython3 -m pip install --user pipx\n```\n\n**Windows:**\n```bash\npython -m pip install --user pipx\n```\n\nAfter installation, ensure pipx is in your PATH:\n```bash\npipx ensurepath\n```\n\n---\n\n## Installation\n\n### Option 1: Install from PyPI (Recommended)\n\n```bash\npip install yfinance-mcp-server\n```\n\n### Option 2: Install from source\n\n```bash\n# 1) Clone the repository\ngit clone https://github.com/itsmejay80/yfinance-mcp-server.git\ncd yfinance-mcp-server\n\n# 2) (Optional) create a virtual environment\npython3 -m venv .venv\nsource .venv/bin/activate\n\n# 3) Install dependencies\npip install -r requirements.txt\n```\n\n---\n\n## Running the …","publisher":null,"homepage":"https://github.com/yourusername/yfinance-mcp-server","repository":"https://github.com/yourusername/yfinance-mcp-server/issues","version":"1.0.4","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","yfinance","yahoo-finance","stocks","financial-data"],"pricing":null,"endpoints":[{"url":"pypi:yfinance-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"},{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"}],"categories":["dev","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":"yfinance-mcp-server","registry":"pypi","observedAt":"2026-09-10T16:24:26.093Z","publishedAt":"2025-07-13T21:41:00.123957Z","latestVersion":"1.0.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yfinance-mcp-server","url":"https://pypi.org/project/yfinance-mcp-server/","firstSeenAt":"2026-09-10T16:23:17.454Z","fetchedAt":"2026-09-10T16:23:17.454Z","normalizedAt":"2026-09-10T16:23:17.454Z"}]},"firstSeenAt":"2026-09-10T16:23:17.454Z","updatedAt":"2026-09-10T16:24:26.093Z"}