<div align="center">

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/rozkoduj/rozkoduj-mcp/main/docs/assets/logo-dark.svg"> <img alt="Rozkoduj MCP" src="https://raw.githubusercontent.com/rozkoduj/rozkoduj-mcp/main/docs/assets/logo.svg" width="220"> </picture>

Rozkoduj MCP - Decode the Markets

Screening, analysis, and scoring across stocks, crypto, and forex - right inside your AI assistant.

</div>

[!TIP]

Just ask

• "Score AAPL - should I buy?"
• "What are today's hidden gems in crypto?"
• "Full analysis of NVDA - technicals, fundamentals, and news"
• "Is the market risk-on or risk-off right now?"

Quick start

Add the hosted server URL to your MCP client:

https://mcp.rozkoduj.com/mcp

Works immediately, no API key needed. Sign in to unlock more tools.

<details> <summary><b>Cursor</b></summary>

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rozkoduj": {
      "url": "https://mcp.rozkoduj.com/mcp"
    }
  }
}

</details>

<details> <summary><b>VS Code</b></summary>

Add to .vscode/mcp.json:

{
  "servers": {
    "rozkoduj": {
      "type": "http",
      "url": "https://mcp.rozkoduj.com/mcp"
    }
  }
}

</details>

<details> <summary><b>Claude Code</b></summary>

claude mcp add rozkoduj --transport http https://mcp.rozkoduj.com/mcp

</details>

<details> <summary><b>Claude Desktop</b></summary>

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rozkoduj": {
      "type": "http",
      "url": "https://mcp.rozkoduj.com/mcp"
    }
  }
}

</details>

<details> <summary><b>Self-hosted (PyPI / Docker)</b></summary>

pip install rozkoduj-mcp       # from PyPI
uvx rozkoduj-mcp               # or run directly
docker run -p 8080:8080 $(docker build -q .)  # Docker

</details>

How it works

You ask in plain language. The AI picks the right tools. You get an answer with evidence - not a data dump.

sequenceDiagram
    autonumber
    participant You
    participant AI as Your AI assistant
    participant R as Rozkoduj MCP

    You->>AI: "Should I buy AAPL?"
    AI->>R: score(AAPL)
    AI->>R: analyze(AAPL, 1d)
    AI->>R: buzz("Apple stock")
    R-->>AI: live indicators · fundamentals · news
    AI-->>You: 59/100 SLIGHT_BUY with reasoning

Same pattern works for any market question:

You ask	You get
"Should I buy AAPL?"	0-100 verdict combining technical, fundamental, and sentiment
"Decode NVDA - full picture."	3-D analysis (1d/4h/1W TA + fundamentals + news), one final verdict
"Hidden gems in crypto today?"	Ranked anomalies - volume spikes, RSI extremes, big moves, 52W breaks
"Do timeframes agree on TSLA?"	15m / 1h / 4h / 1d / 1W side-by-side with alignment score
"Find oversold bounce in EU."	Filtered list: RSI < 30 + MACD bullish cross
"What's the market mood?"	RISK-ON / RISK-OFF + fear & greed + VIX + upcoming events
"Any buzz around Tesla?"	Attention level + fresh headlines with citations

Tools

Find opportunities

Tool	What it does
digest	Scans all global markets and surfaces anomalies ranked by 1-5 star surprise score. Volume spikes, RSI extremes, big moves, 52-week highs/lows - with fundamental context for each gem.
scan	Custom screening with any combination of filters, columns, and sorting. 30+ indicators and fundamental metrics.
smart_screen	One-word preset screens: unusual_volume, oversold_bounce, breakout, momentum, value, dividend, growth.
movers	Top gainers and losers with quality filters.

Analyze a symbol

Tool	What it does
decode	Full 3-dimensional analysis: technical (daily, 4h, weekly), fundamental (valuation, analysts, earnings), and news sentiment. Each dimension scored 0-100, combined into a single verdict.
score	Quick 0-100 score combining technical rating, momentum, volume quality, and trend strength.
analyze	Detailed technical analysis: RSI, MACD, Bollinger Bands, ADX, and 30+ indicators on any timeframe.
fundamentals	Valuation (P/E, P/B, EV/EBITDA), quality scores (Piotroski, Altman Z), analyst consensus, earnings dates, dividends.
compare	Side-by-side technical analysis for up to 10 symbols.
multitf	Multi-timeframe alignment scoring across 15m, 1h, 4h, 1d, 1W.

Read the market

Tool	What it does
market_pulse	Market regime: fear & greed indices + VIX = RISK-ON, RISK-OFF, or NEUTRAL.
buzz	News attention signal for any ticker in any language.
calendar	Upcoming economic events with actual vs forecast vs previous.

Strategies & content

Tool	What it does
list_strategies	Browse Rozkoduj's catalog of published trading strategies. Sort by Sharpe / Sortino / CAGR, filter by family.
strategy_details	Drill into a single strategy by slug or algorithm_uid - full metrics, sparkline, params, data range.
search_articles	Keyword + meaning search across the Rozkoduj blog. Returns slug + locale for citation.
search_knowledge	Hybrid search across Rozkoduj's extended knowledge base. Sign in to unlock.

<details> <summary><b>Resources & Prompts</b></summary>

Type	Name	Description
Resource	rozkoduj://markets	Available markets with IDs
Resource	rozkoduj://fields	Screening fields by category
Resource	rozkoduj://operators	Filter operators for scan
Resource	rozkoduj://freshness-contract	Schema for data_date / freshness / staleness_seconds / fetched_at
Prompt	morning_briefing	Daily overview: regime, movers, calendar
Prompt	deep_dive(symbol)	Full analysis: all tools combined
Prompt	find_opportunities(market)	Multi-screen opportunity scan

</details>

Example prompts

"Should I buy?"

Score AAPL - should I buy?
Decode NVDA - full 3D analysis with news
Compare AAPL, MSFT, GOOGL - which one looks best?

"What's interesting today?"

What are today's market anomalies? Any hidden gems?
Find unusual volume stocks in crypto.
Show me oversold bounce candidates in European markets.

"What's going on?"

Is the market risk-on or risk-off right now?
What economic events are happening this week?
Is there any buzz around Tesla?

Coverage

20+ markets worldwide. Symbols are auto-detected - BTCUSDT routes to crypto, AAPL to US stocks, EURUSD to forex.

License

MIT - rozkoduj.com