Market data for AI agents. Bloomberg Terminal-style screens with formatted output. Not raw JSON - dense, scannable tables ready to interpret. Smart defaults, progressive disclosure.
概览
Market data in Bloomberg Terminal format. Not raw JSON - I give you formatted tables you can read directly. Navigate like BBG: markets() → sector('technology') → ticker('AAPL') → ticker_options('AAPL'). Smart defaults (auto-detects market hours), progressive disclosure (summary → detail). Dense, scannable screens. Factor exposures, momentum, options positioning - all formatted like a professional terminal. Local stdio server, powered by yfinance. All queries user-initiated (no automation - this is a research tool, not production infrastructure). Dense, scannable, professional. Not raw JSON - formatted for humans, AI benefits automatically.
README
以下为原文 README 节选，完整内容请查看原文。
mcp-yfinance-ux
For AI agents: Market data in Bloomberg Terminal format. Not raw JSON - I give you formatted tables you can read directly. Navigate like BBG: markets() → sector('technology') → ticker('AAPL') → ticker_options('AAPL'). Smart defaults (auto-detects market hours), progressive disclosure (summary → detail).
For humans: Dense, scannable screens. Factor exposures, momentum, options positioning - all formatted like a professional terminal.
Technical: Local stdio server, powered by yfinance. All queries user-initiated (no automation - this is a research tool, not production infrastructure).
Example Output
Our differentiator: BBG Lite formatted, agent-friendly screens
MARKETS | Sun 2025-10-26 12:42 EDT
US EQUITIES PRICE CHANGE 1M 1Y
S&P 500 6791.69 +0.79% +2.2% +16.9%
Nasdaq 23204.87 +1.15% +3.2% +25.3%
Dow 47207.12 +1.01% +2.1% +12.1%
Russell 2000 2513.47 +1.24% +3.3% +13.8%
SECTORS TICKER PRICE CHANGE 1M 1Y
Technology XLK 293.58 +1.23% +5.3% +28.3%
Financials XLF 53.11 +0.84% -1.4% +15.6%
Healthcare XLV 146.03 -0.05% +7.8% +0.0%
Energy XLE 88.07 -1.01% -4.3% +1.4%
[... all 11 GICS sectors]
COMMODITIES PRICE CHANGE 1M 1Y
Gold 4137.80 +0.05% +9.6% +51.0%
Oil WTI 61.50 +0.10% -6.4% -14.3%
Data as of 2025-10-26 12:42 EDT | Source: yfinance
Dense, scannable, professional. Not raw JSON - formatted for humans, AI benefits automatically.
Features
Bloomberg Terminal-style navigation screens for market data:
- markets() - Complete factor landscape (US equities, global, sectors, styles, commodities, volatility)
- sector(name) - Sector drill-down with top holdings and factor exposures
- ticker(symbol) - Individual security analysis with full factor decomposition
- Batch comparison - Side-by-side stock analysis with key factors
- Calendar integration - Earnings dates, dividend schedules
- BBG Lite formatting - Dense, scannable, professional output
Library Architecture
mcp-yfinance-ux includes a reusable library for reliable yfinance data fetching.
lib/yfinance_fetcher.py
ONE SOURCE OF TRUTH for yfinance fetching logic:
- Individual
yf.Ticker().history()calls with ThreadPoolExecutor (RELIABLE) - NOT
yf.download()batch API (UNRELIABLE - timeouts, fails entire batch)
Used by:
- MCP server -
mcp_yfinance_ux/historical.pyimports fromlib/ - Portfolio scripts - Can be copied to portfolio agents for reliable fetching
- Any Python code - Pure logic, no MCP dependencies
Key functions:
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"projects": {
"/path/to/your/project": {
"mcpServers": {
"idio-yf": {
"type": "stdio",
"command": "make",
"args": ["-C", "/absolute/path/to/mcp-yfinance-ux", "serve"],
"env": {}
}
}
}
}
}