Skip to main content

Decode the markets with your AI assistant. Screening, analysis, and scoring across stocks, crypto, and forex.

Project description

Rozkoduj MCP

Rozkoduj MCP - Decode the Markets

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

PyPI License: MIT Python 3.14+ CI Deploy Coverage

[!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.

Cursor

Add to ~/.cursor/mcp.json:

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

Add to .vscode/mcp.json:

{
  "servers": {
    "rozkoduj": {
      "type": "http",
      "url": "https://mcp.rozkoduj.com/mcp"
    }
  }
}
Claude Code
claude mcp add rozkoduj --transport http https://mcp.rozkoduj.com/mcp
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rozkoduj": {
      "type": "http",
      "url": "https://mcp.rozkoduj.com/mcp"
    }
  }
}
Self-hosted (PyPI / Docker)
pip install rozkoduj-mcp       # from PyPI
uvx rozkoduj-mcp               # or run directly
docker run -p 8080:8080 $(docker build -q .)  # Docker

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.
Resources & Prompts
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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rozkoduj_mcp-2026.6.9.tar.gz (24.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rozkoduj_mcp-2026.6.9-py3-none-any.whl (35.2 kB view details)

Uploaded Python 3

File details

Details for the file rozkoduj_mcp-2026.6.9.tar.gz.

File metadata

  • Download URL: rozkoduj_mcp-2026.6.9.tar.gz
  • Upload date:
  • Size: 24.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for rozkoduj_mcp-2026.6.9.tar.gz
Algorithm Hash digest
SHA256 3d2b1b5434db7a6e2d96a06f09db551529f8d223aa30b7a5b1f989ed25224457
MD5 dccd547dc3fce83a4344b14884c15c5d
BLAKE2b-256 42d210b505c230fc91b69a9ced19357404feb4e7295420ccd55aa471b553b6f6

See more details on using hashes here.

Provenance

The following attestation bundles were made for rozkoduj_mcp-2026.6.9.tar.gz:

Publisher: publish.yml on rozkoduj/rozkoduj-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rozkoduj_mcp-2026.6.9-py3-none-any.whl.

File metadata

File hashes

Hashes for rozkoduj_mcp-2026.6.9-py3-none-any.whl
Algorithm Hash digest
SHA256 e5ccdb6c2c89105dc284a30cb6f99719b2b75c94c5ea1d9b2a465134ef9e30d7
MD5 b2d5bd4f967bdff45528a9b75d859f62
BLAKE2b-256 9e30305fb2415222699f7f45ef9722c80b13ae948bb0c1fd8545457a9f224c28

See more details on using hashes here.

Provenance

The following attestation bundles were made for rozkoduj_mcp-2026.6.9-py3-none-any.whl:

Publisher: publish.yml on rozkoduj/rozkoduj-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page