Rozkoduj MCP

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"
    }
  }
}
Cursor

Click the Add to Cursor button above, or add to ~/.cursor/mcp.json:

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

Click the Install in VS Code button above, use the CLI:

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

or add to .vscode/mcp.json:

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

Add --scope user to enable it in every project.

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector, then enter:

https://mcp.rozkoduj.com/mcp

Connectors are account-level, so the server is available in both the desktop app and claude.ai. Sign in with Rozkoduj when prompted, or skip it to use the anonymous tier.

ChatGPT

Custom MCP connectors need Developer mode (Plus/Pro/Team/Enterprise/Edu):

  1. Settings → Connectors → Advanced - enable Developer mode.
  2. Settings → Connectors → Create - name it Rozkoduj, set the MCP server URL to https://mcp.rozkoduj.com/mcp, pick OAuth (or No authentication for the anonymous tier), and create.
  3. In a chat, open + → Developer mode and toggle Rozkoduj on.
Self-hosted (PyPI / Docker) 
uvx rozkoduj-mcp               # run straight from PyPI
pip install rozkoduj-mcp       # or install
docker run -p 8080:8080 $(docker build -q .)  # or containerized

Defaults to stdio transport; set MCP_TRANSPORT=streamable-http to serve HTTP. See Self-host with your own key to run as your subscription tier.

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.

You ask You get
"What strategy works best on AAPL?" Strategies backtested on AAPL, ranked by their score on it
"How risky is BTC?" The instrument dossier - volatility, drawdowns, character fingerprint
"What does the research say about position sizing?" Ranked passages with slug + locale for citation

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 hello@rozkoduj.com (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

Project links

Data verified by PyPI on Aug 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for rozkoduj from gravatar.com rozkoduj

Credits

Author: Rozkoduj

GitHub Statistics

Data verified by PyPI on Aug 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.14

Tags

mcp mcp-server trading strategies backtesting leaderboard knowledge-base

Classifiers

Report project as malware

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.8.15.tar.gz (23.7 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.8.15-py3-none-any.whl (29.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: rozkoduj_mcp-2026.8.15.tar.gz
  • Upload date:
  • Size: 23.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for rozkoduj_mcp-2026.8.15.tar.gz
Algorithm Hash digest
SHA256 3a8bbe94b3d602563d695e091b38c7937b3f922eecee43a81882446559a37409
MD5 35d4a028805822b13f7c307735b5080a
BLAKE2b-256 1b9d20d3d78c0ed216164b1f35dc0534b38983c5053c8c4ca4d8b5bf568bbaf4

See more details on using hashes here.

Provenance

The following attestation bundles were made for rozkoduj_mcp-2026.8.15.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.8.15-py3-none-any.whl.

File metadata

File hashes

Hashes for rozkoduj_mcp-2026.8.15-py3-none-any.whl
Algorithm Hash digest
SHA256 0b85a7fb69367533589d0cc6744d28f451eaa357c57365354fdfcfec645df036
MD5 e3435ab48bf54139d1615062e57f00a9
BLAKE2b-256 f36694a683772c2aae37d063af24ff6237aa7ec4d1676a6be7b1e380dd11a58a

See more details on using hashes here.

Provenance

The following attestation bundles were made for rozkoduj_mcp-2026.8.15-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.

Release history Release notifications | RSS feed

This release

2026.8.15 This release

2 files

Supported by

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