yfnhanced-mcp
v1.0.1
Published
Yahoo Finance MCP Server - A Model Context Protocol server for financial data with enterprise-grade resilience, circuit breaker, rate limiting, and data quality validation
Downloads
222
Maintainers
Readme
Yahoo Finance MCP Server
Production-grade financial data infrastructure for AI assistants with enterprise-grade resilience, comprehensive data quality validation, and production-ready monitoring.
Installation
npm install -g yfnhanced-mcpQuick Start
Start Server
yfnhanced-mcpClaude Desktop Integration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"yfnhanced": {
"command": "yfnhanced-mcp"
}
}
}Other AI Tools
Cursor AI / Cline AI:
{
"mcpServers": {
"yfnhanced": {
"command": "yfnhanced-mcp"
}
}
}Features
- 13+ Financial Data Tools: Stocks, crypto, forex, company intelligence, market sentiment
- Circuit Breaker Pattern: Automatic recovery from API failures
- Multi-Strategy Rate Limiting: Token bucket + adaptive + per-endpoint limiting
- Data Quality Scoring: Completeness and integrity validation
- Comprehensive Caching: Graceful fallback with high cache hit ratio (70-90%)
- Enterprise Testing: Unit, integration, e2e, and chaos tests
Available Tools
Market Data
get_quote- Real-time quotes with quality reportingget_historical_prices- OHLCV data with date rangesget_historical_prices_multi- Batch historical data
Company Intelligence
get_quote_summary- Comprehensive company overviewget_balance_sheet- Assets, liabilities, equityget_income_statement- Revenue, expenses, net incomeget_cash_flow_statement- Operating, investing, financing cash flowsget_earnings- Quarterly earnings with estimatesget_analysis- Analyst recommendations and price targetsget_major_holders- Institutional and insider ownership
Market Sentiment
get_news- Latest articles with relevance scoringget_options- Options chains with Greeksget_trending_symbols- Top movers with volume metricsscreener- Filter stocks by 12+ criteria
Cross-Asset
get_crypto_quote- Cryptocurrency pricesget_forex_quote- Currency pair exchange rates
Documentation
For complete documentation including configuration, usage examples, architecture details, and best practices:
View Full Documentation on GitHub
Documentation includes:
- Complete Tool Reference
- Usage Guide with Examples
- Configuration Guide
- Architecture Details
- Data Verification Status
Configuration
Create a config.json file:
{
"rateLimit": {
"requestsPerMinute": 60,
"requestsPerHour": 1500
},
"cache": {
"ttlQuotes": 60000,
"maxCacheSize": 1000
},
"circuitBreaker": {
"failureThreshold": 5,
"monitoringWindow": 60000,
"successThreshold": 3
}
}For detailed configuration options, see Configuration Guide.
Performance
| Metric | Value | |--------|-------| | Quote queries | 60 requests/minute (configurable) | | Batch operations | Up to 100 symbols per request | | Cache hit ratio | 70-90% for frequently accessed symbols | | Cold start time | <500ms | | Test coverage | 95%+ for core middleware |
License
MIT
