Decode the markets with your AI assistant. Screening, analysis, and scoring across stocks, crypto, and forex.
Project description
Rozkoduj MCP - Decode the Markets
Screening, analysis, and scoring across stocks, crypto, and forex - right inside your AI assistant.
[!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
No API key. No setup. Works immediately.
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 from major sources |
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. |
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rozkoduj_mcp-2026.4.25.tar.gz.
File metadata
- Download URL: rozkoduj_mcp-2026.4.25.tar.gz
- Upload date:
- Size: 15.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f4fbf1f084b2845cb31f204b282d85db8ef5357596b7f23cf3208a1d6e9ae30f
|
|
| MD5 |
1058a8ba886c45b086eaaee865556a6b
|
|
| BLAKE2b-256 |
88b1fde934b6ddfca9484e3abdbfd7a438152a56d733e7354d5f18dffe8ea2b6
|
Provenance
The following attestation bundles were made for rozkoduj_mcp-2026.4.25.tar.gz:
Publisher:
publish.yml on rozkoduj/rozkoduj-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rozkoduj_mcp-2026.4.25.tar.gz -
Subject digest:
f4fbf1f084b2845cb31f204b282d85db8ef5357596b7f23cf3208a1d6e9ae30f - Sigstore transparency entry: 1382449768
- Sigstore integration time:
-
Permalink:
rozkoduj/rozkoduj-mcp@2a441570c4331cf20313f7aa9b6634016ac7cf7b -
Branch / Tag:
refs/tags/v2026.4.25 - Owner: https://github.com/rozkoduj
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2a441570c4331cf20313f7aa9b6634016ac7cf7b -
Trigger Event:
release
-
Statement type:
File details
Details for the file rozkoduj_mcp-2026.4.25-py3-none-any.whl.
File metadata
- Download URL: rozkoduj_mcp-2026.4.25-py3-none-any.whl
- Upload date:
- Size: 23.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
434a0a66fe328c9d377474dacc0cdb0839f0315216f83c4ee2319a74213b7a4c
|
|
| MD5 |
27f3dc86ea865f74d5f147dc47063353
|
|
| BLAKE2b-256 |
200496b17853b160988520db9fb68fcd77ba7605754292f45b233a493f3cafaf
|
Provenance
The following attestation bundles were made for rozkoduj_mcp-2026.4.25-py3-none-any.whl:
Publisher:
publish.yml on rozkoduj/rozkoduj-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rozkoduj_mcp-2026.4.25-py3-none-any.whl -
Subject digest:
434a0a66fe328c9d377474dacc0cdb0839f0315216f83c4ee2319a74213b7a4c - Sigstore transparency entry: 1382449781
- Sigstore integration time:
-
Permalink:
rozkoduj/rozkoduj-mcp@2a441570c4331cf20313f7aa9b6634016ac7cf7b -
Branch / Tag:
refs/tags/v2026.4.25 - Owner: https://github.com/rozkoduj
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2a441570c4331cf20313f7aa9b6634016ac7cf7b -
Trigger Event:
release
-
Statement type: