┌─────────────────────────────┬─────────────────────────────────────┐ │ 도구 │ 설명 │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_fetch_stock_data │ 단일 티커의 OHLCV 가격 데이터 조회 │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_fetch_stock_data_batch │ 다중 티커 가격 배치 조회 │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_get_stock_info │ 회사 정보(섹터/시가총액/PER 등) │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_get_news_sentiment │ 뉴스 감성 분석 (Tiingo News + LLM) │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_get_cached_price_data │ DB 캐시된 가격 데이터 즉시 조회 │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_get_chart_links │ 외부 차트(TradingView 등) 링크 생성 │ ├─────────────────────────────┼─────────────────────────────────────┤ │ data_clear_cache │ 캐시 무효화 │ └─────────────────────────────┴─────────────────────────────────────┘
언제: 어떤 분석이든 시작점. 가장 자주 호출되는 도구. 프롬프트 예시: - "AAPL 의 최근 6개월 일봉 데이터 가져와" - "NVDA, AMD, INTC 의 1년 데이터 한꺼번에 받아와" - "TSLA 에 대한 최근 7일 뉴스 감성을 분석해줘"
--- 📈 2. Technical — 기술적 분석 (5개)
리밋: 분당 15회 / 타임아웃: 20초
┌───────────────────────────────────────┬─────────────────────────────────────────────┐ │ 도구 │ 설명 │ ├───────────────────────────────────────┼─────────────────────────────────────────────┤ │ technical_get_rsi_analysis │ RSI 단일 지표 (과매수/과매도 판정) │ ├───────────────────────────────────────┼─────────────────────────────────────────────┤ │ technical_get_macd_analysis │ MACD (추세 전환 신호) │ ├───────────────────────────────────────┼─────────────────────────────────────────────┤ │ technical_get_support_resistance │ 지지/저항선 자동 감지 │ ├───────────────────────────────────────┼─────────────────────────────────────────────┤ │ technical_get_full_technical_analysis │ 종합 기술 분석 (RSI+MACD+BB+SMA 등 한 번에) │ ├───────────────────────────────────────┼─────────────────────────────────────────────┤ │ technical_get_stock_chart_analysis │ 차트 이미지 생성 │ └───────────────────────────────────────┴─────────────────────────────────────────────┘
언제: 종목의 진입/이탈 시점 판단. 프롬프트 예시: - "NVDA 의 RSI 와 MACD 분석해줘" - "AAPL 의 종합 기술 지표 분석을 365일 기준으로 보여줘" - "TSLA 의 지지·저항선 찾아줘"
--- 🎯 3. Screening — 종목 스크리닝 (5개) + Pipeline (4개)
리밋: 분당 10회 / 타임아웃: 25초
기본 스크리닝
┌─────────────────────────────────────────────┬───────────────────────────┐ │ 도구 │ 설명 │ ├─────────────────────────────────────────────┼───────────────────────────┤ │ screening_get_maverick_stocks │ 강세 모멘텀 종목 (현재 시드: 24개) │ ├─────────────────────────────────────────────┼───────────────────────────┤ │ screening_get_maverick_bear_stocks │ 약세 셋업 종목 (16개) │ ├─────────────────────────────────────────────┼───────────────────────────┤ │ screening_get_supply_demand_breakouts │ 수급 돌파 종목 (16개) │ ├─────────────────────────────────────────────┼───────────────────────────┤ │ screening_get_all_screening_recommendations │ 전체 추천 종목 통합 │ ├─────────────────────────────────────────────┼───────────────────────────┤ │ screening_get_screening_by_criteria │ 사용자 정의 기준으로 필터 │ └─────────────────────────────────────────────┴───────────────────────────┘
언제: 매일 아침 시장 스캔, 새로운 진입 후보 발굴. 프롬프트 예시: - "오늘의 Maverick 추천 종목 상위 10개 보여줘" - "수급 돌파 종목 리스트와 RSI > 50 인 종목만 필터해줘" - "어제 대비 Maverick 추천에서 새로 추가된 종목과 빠진 종목 알려줘"
--- 💼 4. Portfolio — 포트폴리오 관리 / 분석 (7개)
리밋: 분당 20회 / 타임아웃: 15초
┌──────────────────────────────────────────┬───────────────────────────────────┐ │ 도구 │ 설명 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_add_position │ 보유 종목 추가 (수량/매입가) │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_get_my_portfolio │ 현재 포트폴리오 조회 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_remove_position │ 종목 제거 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_clear_portfolio │ 전체 비우기 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_risk_adjusted_analysis │ Sharpe/Sortino 등 위험조정 수익률 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_compare_tickers │ 종목간 성과 비교 │ ├──────────────────────────────────────────┼───────────────────────────────────┤ │ portfolio_portfolio_correlation_analysis │ 상관관계/분산 효과 분석 │ └──────────────────────────────────────────┴───────────────────────────────────┘
언제: 본인 포지션 관리, 리밸런싱 검토. 프롬프트 예시: - "AAPL 10주를 150.50 달러에 산 걸 포트폴리오에 추가해줘" - "내 포트폴리오의 Sharpe 비율과 최대 낙폭(MDD)을 계산해줘" - "보유 종목들의 상관관계 매트릭스를 보여줘"
기본 (VectorBT 기반) - run_backtest — 단일 전략 백테스트 - optimize_strategy — 파라미터 그리드 서치 - walk_forward_analysis — 워크포워드 검증 (오버피팅 방지) - monte_carlo_simulation — 몬테카를로 시뮬레이션 - compare_strategies — 다수 전략 동시 비교 - list_strategies — 사용 가능한 전략 목록 (15+) - parse_strategy — 자연어 → 전략 파라미터 변환 - backtest_portfolio — 포트폴리오 단위 백테스트 - generate_backtest_charts / generate_optimization_charts - run_ml_strategy_backtest / train_ml_predictor - analyze_market_regimes — 시장 국면 분석 - create_strategy_ensemble — 전략 앙상블
인텔리전트 (자동 시장 국면 매칭) - run_intelligent_backtest — 시장 국면에 맞는 전략 자동 선택 - quick_market_regime_analysis / explain_market_regime
언제: 전략 검증, 파라미터 튜닝. 프롬프트 예시: - "AAPL 에 모멘텀 전략으로 6개월 백테스트 실행" - "SPY 에 RSI(14, 30, 70) 평균회귀 전략을 5년간 walk-forward 분석" - "MSFT 백테스트에서 Sharpe 최대화하도록 파라미터 그리드 최적화" - "NVDA 의 현재 시장 국면을 분석하고 그에 맞는 최적 전략을 자동 선택해서 백테스트"
--- 🚦 6. Signals — 시그널 알림 / 시장 국면 (8개)
카테고리: TECHNICAL 그룹
┌──────────────────────────────────────────────┬──────────────────────────────────────────┐ │ 도구 │ 설명 │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ create_signal │ 조건부 시그널 등록 (예: "AAPL RSI < 30") │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ update_signal / delete_signal / list_signals │ 시그널 CRUD │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ check_signals_now │ 현재 트리거된 시그널 즉시 평가 │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ get_market_regime │ 현재 시장 국면 판정 (Bull/Bear/Range 등) │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ get_regime_history │ 국면 전환 이력 조회 │ ├──────────────────────────────────────────────┼──────────────────────────────────────────┤ │ backtest_signal │ 시그널의 과거 적중률 검증 │ └──────────────────────────────────────────────┴──────────────────────────────────────────┘
언제: 모니터링 자동화, 매매 트리거 설정. 프롬프트 예시: - "AAPL RSI 가 30 미만이 되면 알림되도록 시그널 만들어줘" - "등록된 시그널 중에 지금 발동된 게 있는지 확인해줘" - "현재 미국 시장 국면을 분석해줘"
프롬프트 예시: - "반도체 관심종목으로 NVDA, AMD, AVGO, TSM 추가해줘" - "내 관심종목의 오늘 변동률 요약과 향후 2주 내 실적 발표 일정 알려줘"
--- ⚠️ 8. Risk Dashboard — 리스크 관리 (4개)
┌──────────────────────────────┬────────────────────────────────────┐ │ 도구 │ 설명 │ ├──────────────────────────────┼────────────────────────────────────┤ │ get_portfolio_risk_dashboard │ VaR/CVaR/베타/익스포저 종합 리스크 │ ├──────────────────────────────┼────────────────────────────────────┤ │ get_position_risk_check │ 신규 진입 시 포지션 사이징 검증 │ ├──────────────────────────────┼────────────────────────────────────┤ │ get_regime_adjusted_sizing │ 시장 국면 기반 포지션 사이즈 조정 │ ├──────────────────────────────┼────────────────────────────────────┤ │ get_risk_alerts │ 리스크 임계치 초과 경고 │ └──────────────────────────────┴────────────────────────────────────┘
프롬프트 예시: - "내 포트폴리오의 95% VaR 와 베타를 계산해줘" - "AAPL 50주를 추가로 살 때 포지션 사이징이 적절한지 검증해줘" - "현재 시장 국면 기준으로 권장 포지션 비중을 알려줘"
--- 📔 9. Journal — 매매일지 (6개)
┌─────────────────────────────────────────┬───────────────────────────────────┐ │ 도구 │ 설명 │ ├─────────────────────────────────────────┼───────────────────────────────────┤ │ journal_add_trade / journal_close_trade │ 트레이드 기록 입출 │ ├─────────────────────────────────────────┼───────────────────────────────────┤ │ journal_list_trades │ 거래 이력 │ ├─────────────────────────────────────────┼───────────────────────────────────┤ │ get_strategy_performance │ 전략별 성과 분석 │ ├─────────────────────────────────────────┼───────────────────────────────────┤ │ get_strategy_comparison │ 전략간 비교 │ ├─────────────────────────────────────────┼───────────────────────────────────┤ │ journal_trade_review │ 거래 사후 분석 (진입/청산 적정성) │ └─────────────────────────────────────────┴───────────────────────────────────┘
프롬프트 예시: - "NVDA 50주를 어제 880달러에 매수, 모멘텀 전략으로 기록해줘" - "내가 지난달 사용한 모멘텀 vs 평균회귀 전략 성과 비교해줘"
--- 🤖 10. Research — AI 리서치 (4개) ⚠️ OPENROUTER_API_KEY 필요
리밋: 분당 2회 / 타임아웃: 300초 / 비용 발생
┌───────────────────────────────────┬───────────────────────────────────────────┐ │ 도구 │ 설명 │ ├───────────────────────────────────┼───────────────────────────────────────────┤ │ research_comprehensive_research │ 임의 주제 종합 리서치 (웹 검색 + AI 분석) │ ├───────────────────────────────────┼───────────────────────────────────────────┤ │ research_analyze_market_sentiment │ 시장/섹터 감성 분석 │ ├───────────────────────────────────┼───────────────────────────────────────────┤ │ research_company_comprehensive │ 기업 종합 리서치 (펀더멘털 + 경쟁 분석) │ ├───────────────────────────────────┼───────────────────────────────────────────┤ │ research_search_financial_news │ 최근 금융 뉴스 검색 │ └───────────────────────────────────┴───────────────────────────────────────────┘
프롬프트 예시: - "AI 반도체 산업 종합 리서치하고 상위 3개 기회를 식별해줘" - "2026년 양자컴퓨팅 섹터 시장 감성을 분석해줘"
--- 🧠 11. Agents — 멀티 에이전트 분석 (7개) ⚠️ OPENROUTER_API_KEY 필요
리밋: 분당 3회 / 타임아웃: 120초 / 고비용
┌─────────────────────────────────────┬─────────────────────────────────────────┐ │ 도구 │ 설명 │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_list_available_agents │ 사용 가능 에이전트 목록 │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_analyze_market_with_agent │ 단일 에이전트 분석 (모멘텀/평균회귀 등) │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_get_agent_streaming_analysis │ 스트리밍 분석 │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_compare_personas_analysis │ 보수적/공격적/모험적 등 퍼소나별 비교 │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_orchestrated_analysis │ 다중 에이전트 자동 라우팅 (LLM 지휘자) │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_deep_research_financial │ 심층 리서치 (장시간 작업) │ ├─────────────────────────────────────┼─────────────────────────────────────────┤ │ agents_compare_multi_agent_analysis │ 여러 에이전트 동시 분석 비교 │ └─────────────────────────────────────┴─────────────────────────────────────────┘
언제: 단일 도구 호출로 끝나지 않는 복잡한 분석. 프롬프트 예시: - "공격적/보수적 퍼소나 관점에서 동일하게 SPY 매수 타이밍을 평가해줘" - "NVDA 에 대해 기술적·펀더멘털·뉴스 에이전트를 동시에 돌려서 결과 비교"
Introspection / Status - discover_capabilities — 사용 가능 도구/카테고리 자동 발견 - list_all_strategies / get_strategy_help - get_decision_log — 에이전트 결정 감사 로그 - get_tool_registry_status — 현재 레이트 리밋 사용량
프롬프트 예시: - "maverick-mcp 의 모든 기능을 확인해줘" (discover_capabilities 자동 호출) - "현재 시스템 상태와 캐시 적중률을 보여줘"
시나리오 A — 일일 시장 스캔 1. screening_get_all_screening_recommendations → 후보 추출 2. data_get_news_sentiment → 후보별 뉴스 감성 확인 3. technical_get_full_technical_analysis → 상위 후보 기술 분석 4. watchlist_add → 관심종목 등록
시나리오 B — 종목 깊이 분석 1. data_get_stock_info + data_fetch_stock_data (1년) 2. technical_get_full_technical_analysis 3. research_company_comprehensive (펀더멘털) 4. run_intelligent_backtest (현재 국면 맞춤 전략 검증)
시나리오 C — 진입 전 리스크 점검 1. get_position_risk_check (포지션 사이징 검증) 2. get_regime_adjusted_sizing (국면 보정 비중) 3. portfolio_portfolio_correlation_analysis (분산 효과) 4. journal_add_trade (체결 후 기록)
---
▎ 💬 사용 팁: Claude Code 에 자연어로 요청하면 적절한 도구가 자동 호출됩니다. 도구 이름을 외울 필요는 없고, "NVDA 의 RSI 보여줘" 정도로 충분합니다. 다만 Research/Agent 카테고리는 OPENROUTER_API_KEY 가 .env 에 설정되어 있어야 동작합니다(현재는 미설정 상태).
