Agent skill

Kraken MCP Integration

by krakenfx in krakenfx/kraken-cli

Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers.

MITAuto-check passedAgent Workflows

Install Kraken MCP Integration

skills CLI
$ npx skills add krakenfx/kraken-cli --skill kraken-mcp-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install krakenfx/kraken-cli kraken-mcp-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/krakenfx/kraken-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kraken-mcp-integration .claude/skills/kraken-mcp-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kraken-mcp-integration
GitHub stars
751
Token cost
~1.5k tokens
SKILL.md length
645 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers.

  • Works in 3 steps: Configure your MCP client → Set credentials (only needed for live… → Restart your MCP client
  • Tasks that involve MCP servers
  • SKILL.md covers Supported Clients, Setup, Service Filtering and Enabling live trading, plus 3 more sections
  • Calls gemini; needs KRAKEN_API_KEY and KRAKEN_API_SECRET

What it does

Kraken MCP Integration is an agent skill from krakenfx/kraken-cli. Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: The first AI-native CLI for trading crypto, stocks, forex, and derivatives. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/kraken-mcp-integration”

Requirements

  • A credential in KRAKEN_API_KEY
  • A credential in KRAKEN_API_SECRET

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Configure your MCP client
  2. Set credentials (only needed for live trading)
  3. Restart your MCP client

What it can do on your machine

Read from SKILL.md and the folder at commit aa56e59. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gemini

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KRAKEN_API_KEY
    • KRAKEN_API_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kraken MCP Integration loads about 1.5k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 645 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from krakenfx/kraken-cli at commit aa56e59, republished under its MIT licence (© krakenfx). 645 words, ~1,456 tokens.

Download SKILL.mdSave it as .claude/skills/kraken-mcp-integration/SKILL.md (or your agent's skills folder).
name
kraken-mcp-integration
description
Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers.
version
1.0.0

kraken-mcp-integration

Use this skill to connect any MCP-compatible client to kraken-cli for structured tool calling over stdio.

MCP tool calls execute through the same command path as CLI commands, so error handling and rate-limit behavior is identical between MCP and CLI.

Supported Clients

Claude Desktop, ChatGPT, Codex, Gemini CLI, Cursor, VS Code, Windsurf, and any client that supports the MCP mcpServers configuration block.

Setup

1. Configure your MCP client

Add this to your MCP client configuration (Claude Desktop: claude_desktop_config.json, Cursor: .cursor/mcp.json, etc.):

json
{
  "mcpServers": {
    "kraken": {
      "command": "kraken",
      "args": ["mcp", "-s", "market,paper,feedback"]
    }
  }
}

-s market,paper,feedback is the default service list: public market data, paper trading, and the local feedback tool. No real funds can be touched until you opt in explicitly by expanding the service list. See Enabling live trading below.

Credential resolution follows the standard CLI precedence: command-line flags, then KRAKEN_API_KEY / KRAKEN_API_SECRET in the MCP server's env block, then a secure local config file managed by the CLI (written by kraken auth set and kraken setup, stored with user-only permissions in your OS's standard config directory). The MCP server and the standalone CLI share the same config file, so a single kraken auth set serves both.

2. Set credentials (only needed for live trading)

If you stay on market,paper,feedback, skip this step — paper trading needs no keys.

For live trading, the MCP server reads credentials from environment variables:

bash
export KRAKEN_API_KEY="your-key"
export KRAKEN_API_SECRET="your-secret"
3. Restart your MCP client

The client discovers tools on startup.

Service Filtering

Control which command groups the MCP server exposes:

bash
kraken mcp -s market                    # public data only (safe, no auth)
kraken mcp -s market,paper,feedback              # market data + paper trading (marketplace default)
kraken mcp -s market,trade,paper        # add live trading
kraken mcp -s market,account,trade      # add account queries and live trading
kraken mcp -s all                       # everything (many tools, includes funding/earn/subaccount)

Keep the service list to what you need. MCP clients typically handle 50-100 tools well.

ServiceAuthToolsRisk
marketNo~10None
accountYes~18Read-only
tradeYes~9Orders (dangerous)
fundingYes~10Withdrawals (dangerous)
earnYes~6Staking (dangerous)
subaccountYes~2Transfers (dangerous)
futuresMixed~39Orders (dangerous)
paperNo~10None (simulation)
authNo~3Read-only (auth set/auth reset excluded)

Enabling live trading

Every kraken-cli marketplace listing ships with -s market,paper,feedback by default, so a fresh install can never place a real order. To opt in to live trading, edit the MCP server args in your client's config and widen the service list:

json
{
  "mcpServers": {
    "kraken": {
      "command": "kraken",
      "args": ["mcp", "-s", "market,trade,paper"],
      "env": {
        "KRAKEN_API_KEY": "your-key",
        "KRAKEN_API_SECRET": "your-secret"
      }
    }
  }
}

Recommended upgrade path:

  1. Start with market,paper,feedback (the default).
  2. Add trade once you are comfortable and have an API key scoped to orders only. See the "Recommended key scope" section of skills/kraken-setup/SKILL.md before generating a key.
  3. Add account if you want the agent to read balances and positions.
  4. Only enable funding, earn, subaccount, or all if you specifically need those workflows. Each of these unlocks tools that can move funds off the exchange or alter account structure.

Switching to -s all expands the set of tools the agent can reach by prompt-injection or mistake. Prefer a narrow list and widen it deliberately.

Show full SKILL.md (193 more words)Show less

Safety

Dangerous tools include [DANGEROUS: requires human confirmation] in their description and carry the MCP destructive_hint annotation. In guarded mode (default), calls must include acknowledged=true. In autonomous mode (--allow-dangerous), the per-call confirmation is disabled. MCP clients that respect annotations may still prompt at the client layer.

For fully autonomous operation, see skills/kraken-autonomy-levels/SKILL.md.

Gemini CLI Extension

If using Gemini CLI, install the extension directly:

bash
gemini extensions install https://github.com/krakenfx/kraken-cli

The gemini-extension.json includes mcpServers config, so the MCP server starts automatically.

Troubleshooting

"No tools found": Check that kraken is on your PATH and the service list is valid. Run kraken mcp -s market manually to verify it starts.

Auth errors on tool calls: Set KRAKEN_API_KEY and KRAKEN_API_SECRET in the environment where your MCP client runs.

Too many tools: Reduce the service list. kraken mcp -s market,trade is a good starting point.

Streaming commands not available: WebSocket streaming commands are excluded from MCP v1. Use kraken ws ... directly from the terminal for streaming.

If you hit a mismatch between what you are trying to do and the CLI's interface or responses — including a mismatch between this skill and the installed CLI version's contract — feel free to submit feedback with kraken feedback.

© krakenfx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/kraken-mcp-integration of krakenfx/kraken-cli.

Open the folder on GitHubat commit aa56e59

Compare with similar skills

Kraken MCP Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kraken MCP Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kraken MCP Integration this skillkrakenfx/kraken-cli751—~1.5kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed

More from krakenfx/kraken-cli

All 59 skills in this repo
  • Kraken Alert Patterns

    krakenfx/kraken-cli

    Price alerts, threshold monitoring, and notification triggers for agents.

    751 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Autonomy Levels

    krakenfx/kraken-cli

    Progress from manual trading to full agent autonomy with controlled risk at each level.

    751 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Basis Trading

    krakenfx/kraken-cli

    Capture the spot-futures price spread with delta-neutral basis trades.

    751 GitHub stars~802 tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Dca Strategy

    krakenfx/kraken-cli

    Dollar cost averaging with scheduled buys and performance tracking.

    751 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Earn Staking

    krakenfx/kraken-cli

    Discover staking strategies, allocate funds, and track earn positions.

    751 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Kraken Error Recovery

    krakenfx/kraken-cli

    Handle order failures, network errors, and duplicate submissions safely.

    751 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Kraken MCP Integration

What does Kraken MCP Integration do?

Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers. Kraken MCP Integration is an agent skill from krakenfx/kraken-cli. Connect MCP clients to kraken-cli for native tool calling without subprocess wrappers.

When should I use Kraken MCP Integration?

Kraken MCP Integration fits situations like: tasks that involve MCP servers.

How do I install Kraken MCP Integration in Claude Code?

Run `npx skills add krakenfx/kraken-cli --skill kraken-mcp-integration -a claude-code`. Or copy the skill folder (skills/kraken-mcp-integration in krakenfx/kraken-cli) into .claude/skills/kraken-mcp-integration in your project. Claude Code loads it when a task matches its description.

How do I install Kraken MCP Integration in Codex?

Run `npx skills add krakenfx/kraken-cli --skill kraken-mcp-integration -a codex`. Or copy the skill folder (skills/kraken-mcp-integration in krakenfx/kraken-cli) into .agents/skills/kraken-mcp-integration in your project. Codex loads it when a task matches its description.

Can I use Kraken MCP Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add krakenfx/kraken-cli --skill kraken-mcp-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kraken-mcp-integration, .gemini/skills/kraken-mcp-integration, .github/skills/kraken-mcp-integration and .opencode/skills/kraken-mcp-integration in your project.

What does Kraken MCP Integration need to run?

Going by SKILL.md and its folder, Kraken MCP Integration needs the command-line tools its instructions call (gemini) and credentials named KRAKEN_API_KEY and KRAKEN_API_SECRET. Our summary lists: A credential in KRAKEN_API_KEY; A credential in KRAKEN_API_SECRET.

Does Kraken MCP Integration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kraken MCP Integration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kraken MCP Integration use?

Kraken MCP Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kraken MCP Integration use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kraken MCP Integration?

Skills that share tags, products or a category with Kraken MCP Integration: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kraken MCP Integration?

krakenfx (a GitHub organization) maintains it in krakenfx/kraken-cli, which has 751 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on August 7, 2026.

Source: krakenfx/kraken-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.