{"id":"staskh-trading-skills","name":"trading_skills","homepage":null,"repo_url":"https://github.com/staskh/trading_skills","category":"ai-ml","subcategories":[],"tags":["ai-trading","options","mcp","claude-desktop","ibkr","technical-analysis","risk-metrics","python"],"what_it_does":"Trading_skills provides an AI-assisted interface (Claude Code/Cursor integration and a Claude Desktop MCP server) for market and options analysis. It pulls market data (Yahoo Finance) for quotes/history/fundamentals/news/earnings and computes technical indicators, option Greeks, spread analysis, and risk metrics; it can also connect to Interactive Brokers via TWS/IB Gateway to summarize a portfolio and generate event/earnings-aware action reports and option roll candidates (per README descriptions).","use_cases":["Conversational market scans for equities (bullish setups)","Options research: option chain, Greeks, spread strategy evaluation","Correlation/diversification analysis across symbols","Event-focused analysis: earnings calendar and earnings risk flags","PMCC suitability scanning and report generation","Portfolio review and action reporting for Interactive Brokers accounts","Identifying candidate rolls for expiring short calls/covered calls/puts","Generating consolidated reports from exported IBRK trade CSVs (as described)"],"not_for":["Automated trade execution without human review or broker-side safeguards","Latency-critical execution (e.g., high-frequency trading)","Compliance/regulated advisory use without appropriate legal/financial approvals","Use by agents without explicit controls for sending sensitive data to brokers/LLM tools"],"best_when":"You want an agent-friendly, local-tool workflow to answer trading research questions (especially options/earnings/risk) and optionally to augment analysis with IB portfolio data.","avoid_when":"You need a formally specified, strongly authenticated hosted API/SDK with strict governance; or you cannot securely manage broker connectivity and any required credentials/session state.","alternatives":["Other retail options research tools with APIs/exports (e.g., Thinkorswim workflows, QuantConnect research notebooks)","Broker-native analytics/reporting and account statements","Open-source trading research frameworks combined with charting/IBKR APIs (e.g., ib-insync examples + your own analysis)","Commercial options analysis platforms that provide programmatic access or documented APIs"],"af_score":57.0,"security_score":39.8,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:18:27.810449+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["Python"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Interactive Brokers TWS/IB Gateway connection (per README: socket clients; port 7496/7497).","Local execution with pip/uv; no cloud account described for the MCP server itself."],"oauth":false,"scopes":false,"notes":"README describes IB connectivity via TWS/IB Gateway and enabling API connections; it does not describe OAuth/scoped API keys. Security/auth model for the local MCP server and IB credentials is not documented in the provided text."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No explicit SaaS pricing. MCP use is positioned for Claude Desktop (including free tier), but the package itself is a library/tool installed locally."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":57.0,"security_score":39.8,"reliability_score":28.8,"mcp_server_quality":72.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":55.0,"rate_limit_clarity":15.0,"tls_enforcement":55.0,"auth_strength":35.0,"scope_granularity":20.0,"dependency_hygiene":60.0,"secret_handling":35.0,"security_notes":"Security posture is partially inferable: transport appears to depend on local connections to IB (TLS/enforcement not specified). Authentication/authorization for the MCP server and secure handling of any IB credentials or session details are not described. The tool consumes external data from Yahoo Finance (potential data integrity concerns). Dependency list includes networking/SDK-like packages (yfinance, ib-async, mcp, lxml, scipy); no CVE/dependency audit information is provided in the provided text.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":40.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["IB features require a running TWS/IB Gateway and API permissions; failures may occur if port/connection settings are wrong (README mentions paper vs live ports).","Market data may be delayed up to 15 minutes (Yahoo Finance), which agents may need to account for when reasoning about “real-time” quotes.","Some tools/skills are listed as under development (e.g., `ib-option-chain`), so agents should handle missing/partial coverage gracefully."]}}