kraken-cli
Trade crypto, tokenized stocks, forex and futures on Kraken from your terminal or your AI agent. Built-in MCP server for Claude, Codex and Cursor, JSON output, and paper trading on live prices.
Install / Use
claude mcp add krakenfx -- npx -y github:krakenfx/kraken-cliIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of kraken-cli
kraken-cli scores 83/100 on our quality scale, 648th of 950 AI & Machine Learning skills we index.
Its MCP Server is 141 KB long, well organised into 90 sections with 57 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 812 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated 18 days ago, so kraken-cli is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful.
- noteInstalls by piping a downloaded script into a shellline 16
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh - noteInstalls by piping a downloaded script into a shellline 124
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
kraken-cli compared with similar skills
All 4 of these similar skills score higher than kraken-cli; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| kraken-cli (this skill)by krakenfx | 83 | 812 | 18d ago | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install kraken-cli?
- Run
claude mcp add krakenfx -- npx -y github:krakenfx/kraken-cli. The install tabs above show the steps for each supported agent. - Which AI agents does kraken-cli work with?
- It is written for Claude Code, Claude Desktop, Cursor, Zed and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is kraken-cli safe to use?
- Our scan of the first 100 KB of the file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands (2 minor notes below). An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is kraken-cli still maintained?
- The repository was last updated 18 days ago, so kraken-cli is actively maintained.
Skill content
View source on GitHubKraken CLI
Trade on Kraken from your terminal, or let your AI agent trade for you. One install covers crypto, tokenized U.S. stocks and ETFs (for non-U.S. customers), forex, and futures. Every command can answer in JSON. A built-in MCP server connects the CLI to Claude, Cursor, Codex and other agents, and paper trading runs on live prices with no account.
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
source "$HOME/.cargo/env" # puts kraken on your PATH in this terminal
kraken ticker BTCUSD # live price, no account needed
<!-- prettier-ignore -->
[!TIP] New: sign in with OAuth. You no longer have to fumble around for API keys.
kraken auth loginopens Kraken in your browser, you approve, and the CLI saves a restricted Spot API key for you. The key can't withdraw funds, and it expires on its own. See how it works.
With kraken-cli you can:
- Trade 1,400+ crypto pairs, 170+ tokenized U.S. stocks and ETFs (xStocks), 12 forex pairs and 200+ futures contracts. What you can trade
- Practice on paper first. Paper orders fill at live prices and need no Kraken account, and the basic order commands are the same as live. Paper trading
- Connect Claude, Cursor, Codex, Gemini and other MCP clients through
kraken-mcp, which serves up to 152 MCP tools. On clients that support MCP elicitation, calls that move money ask you first; thekrakenCLI itself places orders without a prompt. MCP server - Script it: every command takes
-o json, and a failure comes back as JSON with a stableerrorfield and a non-zero exit code. For AI agents - Record live market data and replay it into paper sessions, then score a strategy against pass criteria you fixed before the first run. Workspaces, sessions, and research
- Start from 59 agent skills for DCA, grid trading, rebalancing, futures risk and more. Agent skills
| You are | Start here |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A person at a terminal | Install, then follow the Quick start from sign-in to your first order. |
| An AI agent, or building one | Read For AI agents and AGENTS.md. Ask your human to open a new terminal and run kraken auth login there, then call kraken <command> -o json 2>/dev/null. Orders trade real money with no confirmation prompt, so follow the rules for trading real money. |
| Just looking around | Market data and paper trading need no account. Try steps 1 and 2 of the Quick start. |
Paste one of these prompts into Claude Code, Codex, Cursor, or another AI coding agent. No agent yet? Install Claude Code first.
Install kraken-cli (https://github.com/krakenfx/kraken-cli) and tell me how to sign in with OAuth.
Install kraken-cli (https://github.com/krakenfx/kraken-cli) and build me a morning market brief.
With kraken-cli, watch ETH, SOL, and BTC for 30 seconds. What are the pros and cons of buying each right now?
With kraken-cli, look up AAPLx, TSLAx, and SPYx on xStocks. Summarize how each is performing today.
You are a Wall Street veteran with 20 years of experience. You have 1 minute. Paper trade BTC with kraken-cli and show me your P&L.
With kraken-cli futures paper trading, open a 10x leveraged long on BTC with $5,000 collateral. Set a trailing stop at 3%.
If kraken-cli is useful to you, star the repo so other traders and agent builders can find it. To hear about new releases, choose Watch > Custom > Releases on the repo page.
<!-- prettier-ignore -->[!CAUTION] Experimental software. It interacts with the live Kraken exchange and can execute real financial transactions. Read DISCLAIMER.md before using it with real funds or AI agents.
Contents
- Installation
- Quick start
- Sign in with OAuth
- API keys & configuration
- What you can trade
- Paper trading
- For AI agents
- Output and errors
- MCP server
- Workspaces, sessions, and research
- Commands
- Examples
- Agent skills
- Troubleshooting
- Star history
- Development
- Contributing
- License & disclaimer
Installation
One install, no runtime dependencies. It puts three binaries on your PATH:
kraken, kraken-mcp (the MCP server) and kraken-shell (an interactive
shell).
One-liner
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh | sh
The installer detects your OS and architecture, downloads the right build, and installs it. macOS (Apple Silicon and Intel) and Linux (x86_64 and ARM64) are supported. On Windows, use WSL. AI agents: ask your human before you run the installer on their machine.
Open a new terminal (or run source "$HOME/.cargo/env"), then check that it
works:
kraken status && kraken ticker BTCUSD
<!-- prettier-ignore -->
[!NOTE]
command not found: krakenright after install? The installer puts the binaries in~/.cargo/bin(or$CARGO_HOME/binif you set it) and adds that folder to your PATH for new terminals only.
- AI agent in the middle of a task: call
~/.cargo/bin/kraken(or$CARGO_HOME/bin/kraken) by its full path for the rest of the session.- Terminal: open a new window, or run
source "$HOME/.cargo/env"($CARGO_HOME/envif you set it,env.fishfor fish).- Claude Code, Codex, or another agent you start in a terminal: quit it, open a new terminal window, and start it there. The old window keeps the old PATH.
- Cursor, VS Code, Claude Desktop, or another desktop app: quit it and open it again. If it still can't find
kraken, use the full path thatcommand -v krakenprints in a new terminal.
Pre-built binaries are also on the GitHub Releases page.
Verifying binaries
Releases are signed with minisign. Every
release archive, its .sha256 file, the installer script and SHA256SUMS.txt
on the Releases page has a
matching .minisig signature file.
Download the archive and its .minisig into the same folder, then check it
against the public key:
minisign -Vm kraken-cli-aarch64-apple-darwin.tar.gz -P RWQJue8SwPzZBZO8Up5ppAUqm0wM/gK5yjnam+Dbf7KbY0utkiO+7XCd
Public key:
RWQJue8SwPzZBZO8Up5ppAUqm0wM/gK5yjnam+Dbf7KbY0utkiO+7XCd
Install minisign with brew install minisign (macOS) or apt install minisign
(Linux). To check the installer before you run it:
curl -LO https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh
curl -LO https://github.com/krakenfx/kraken-cli/releases/latest/download/kraken-cli-installer.sh.minisig
minisign -Vm kraken-cli-installer.sh -P RWQJue8SwPzZBZO8Up5ppAUqm0wM/gK5yjnam+Dbf7KbY0utkiO+7XCd && sh kraken-cli-installer.sh
<details>
<summary>Build from source</summary>
Requires Rust 1.97 or later. If cargo says a newer rustc
is required, run rustup update. A clone pins its toolchain in
rust-toolchain.toml, so rustup may download that version on the first build.
A source build is DuckDB-free by default, because the bundled DuckDB C++ build
dominates compile time and only DuckDB tapes need it: writing one
(kraken record --to duckdb) or reading one, such as a 0.4.x tape. Pass
--features record-duckdb to any command below to include it; the released
binaries already carry it.
Both commands install all three binaries: kraken, kraken-mcp and
kraken-shell.
cargo install --locked --git https://github.com/krakenfx/kraken-cli kraken-cli
Or clone and build:
git clone https://github.com/krakenfx/kraken-cli.git
cd kraken-cli
cargo install --locked --path crates/kraken-cli
If an earlier source install added kraken-mcp or kraken-shell, cargo stops
with "binary already exists". Run cargo uninstall kraken-mcp kraken-shell
first, or add --force.
Quick start
Steps 1 and 2 need no account. To trade real money you need a verified Kraken account with funds in it; you can create one on kraken.com.
1. Look at the market
Public market data needs no credentials, so nothing here can touch an account.
kraken ticker BTCUSD
kraken orderbook BTCUSD --count 10
kraken ohlc BTCUSD --interval 60
Output is a table. Add -o json to any command for JSON. REST commands accept
BTCUSD, BTC/USD or XBTUSD; the examples for streaming commands (ws,
record, session) use BTC/USD.
2. Practice with paper trading
kraken workspace create sandbox --capital 10000 --mode paper
export KRAKEN_WORKSPACE=sandbox
kraken paper buy BTCUSD 0.01
kraken workspace status
unset KRAKEN_WORKSPACE
Paper orders fill at live prices with simulated money. paper buy may log a
warning that no session is recording; you can ignore it here.
While KRAKEN_WORKSPACE names a paper workspace, kraken order buy and
kraken balance act on the simulated account as well. The last line unsets it
so the next steps reach your real account. Paper trading
covers the rest.
3. Sign in
kraken auth login
kraken auth test
kraken auth login opens Kraken's sign-in page in your browser. Sign in,
approve access, and the CLI saves a Spot API key for you. The key covers spot
crypto, xStocks and forex, can't withdraw funds, and expires after 90 days. Run
it yourself in an interactive terminal: it refuses to run from a script, a CI
job
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
