Rozkoduj

Decode the Markets

Market intelligence for your AI assistant - algo-trading strategies, analytics and specialized research knowledge.

PyPI License: MIT Python 3.14+ CI Coverage

Add to Cursor Install in VS Code

Just ask

• "What strategy works best on AAPL?"
• "Show me the top strategy's backtest - return, max drawdown, win rate."
• "How risky is BTC?"
• "How do I avoid overfitting a backtest?"

Getting started

The hosted server works immediately - no API key, no sign-up. Signing in on a paid tier adds the deeper knowledge base to research results.

Standard config works in most MCP clients:

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

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

code --add-mcp '{"name":"rozkoduj","type":"http","url":"https://mcp.rozkoduj.com/mcp"}'

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

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

https://mcp.rozkoduj.com/mcp

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

How it works

You ask in plain language. The AI picks the right tool. You get an answer with evidence - strategy metrics you can rank, or research passages you can cite - not a data dump.

Tools

One tool per pillar. All four are read-only.

• leaderboard - the strategy leaderboard: published, backtested strategies, ranked. Sort by score or APY - apy_desc ranks by cagr_usd (annualised return in USD, the cross-market canon; local cagr is the fallback); filter by family or by instrument symbol ("what works best on AAPL?").
• strategy - one strategy's full dossier: metrics, risk mode, parameters, and the backtest summary.
• instrument - the catalog of covered markets, or one instrument's dossier: buy-and-hold facts and the six-axis character fingerprint.
• research - one search across the research: articles plus, on paid tiers, the deeper knowledge base. Returns cited passages.

Example prompts

Explore the leaderboard

What strategy works best on AAPL?
Show me the highest-APY strategy and its max drawdown.
Which strategy family performs best?

Dig into a strategy

Give me the full details on the MA Crossover strategy.
What's the win rate and risk mode of your top strategy?

Explore the markets

Which markets do you cover?
How risky is BTC - volatility, drawdowns, character?

Search the research

How do I avoid overfitting a backtest?
Find articles about position sizing and drawdown control.

Self-host with your own key

The hosted server at https://mcp.rozkoduj.com/mcp authenticates to the data API automatically. When you self-host the package, supply your own Rozkoduj API key so calls run as your subscription tier instead of the anonymous tier:

1. Ask for a key at [email protected] (format rzk_ + 40 hex). It maps to your account's tier.
2. Provide it via the ROZKODUJ_API_KEY environment variable - never inline in committed config. In an MCP client, reference it as ${env:ROZKODUJ_API_KEY}.
3. A malformed value is ignored (requests fall back to anonymous); the active posture is logged at startup, prefix only - the key is never logged.

Precedence: ROZKODUJ_API_KEY (self-host) > anonymous. The hosted server authenticates automatically.

License

MIT - rozkoduj.com