Kraken Money Mode Router

For Claude: How to Use This Skill

Skill instructions are preloaded in context when this skill is active. Do not perform filesystem searches or tool-driven exploration to rediscover them; use the guidance below directly.

Windows / Seren Desktop Python Runtime

Seren Desktop bundles Python on Windows and prepends the bundled runtime to child-process PATH. When running from Seren Desktop on Windows, use the documented python3 ... commands as written; they resolve to Seren Desktop's bundled python3.exe even when system Python is not installed. Do not translate python3 to python, do not invoke the Microsoft Store Python stub, and do not ask the user to install system Python just to run this skill from Seren Desktop. If a snippet includes Unix virtualenv activation such as source .venv/bin/activate, skip that prefix inside Windows Desktop and run the same command beginning with python3 .... Outside Seren Desktop, use an installed Python 3.11+ interpreter or a project .venv.

Route users to the best Kraken product flow fast.

Use this skill when a user asks things like:

• "What should I use in Kraken?"
• "Should I trade, invest, pay, or go on-chain?"
• "Give me a plan for my money on Kraken"

What It Does

1. Captures user intent with a short questionnaire.
2. Scores Kraken money modes against user goals.
3. Returns a primary mode and backup mode.
4. Produces a concrete action checklist users can execute immediately.
5. Stores session, answers, recommendations, and action plan in SerenDB.

Modes

• payments -> Krak-focused everyday money movement
• investing -> multi-asset portfolio building
• active-trading -> hands-on market execution
• onchain -> Kraken spot funding endpoints for deposits, withdrawals, and wallet transfers
• automation -> rules-based, repeatable execution

API Key Setup

Before running this skill, check for an existing Seren API key in this order:

1. Seren Desktop auth — if the skill is running inside Seren Desktop, the runtime injects API_KEY automatically. Check: echo $API_KEY. If set, no further action is needed.
2. Existing .env file — check if SEREN_API_KEY is already set in the skill's .env file. If set, no further action is needed.
3. Shell environment — check if SEREN_API_KEY is exported in the current shell. If set, no further action is needed.

Only if none of the above are set, register a new agent account:

curl -sS -X POST "https://api.serendb.com/auth/agent" \
  -H "Content-Type: application/json" \
  -d '{"name":"money-mode-router"}'

Extract the API key from the response at .data.agent.api_key — this key is shown only once. Write it to the skill's .env file:

SEREN_API_KEY=<the-returned-key>

Verify:

curl -sS "https://api.serendb.com/auth/me" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Do not create a new account if a key already exists. Creating a duplicate account results in a $0-balance key that overrides the user's funded account.

Reference: https://docs.serendb.com/skills.md

Setup

1. Copy .env.example to .env.
2. Ensure seren-mcp is available locally and authenticated (Seren Desktop login context).
3. Set SEREN_API_KEY (required for Kraken account context and MCP auth when running standalone).
4. Optionally set MCP DB target env vars (SERENDB_PROJECT_NAME, SERENDB_DATABASE, optional branch/region).
   • If SERENDB_DATABASE is not set, the router first tries to reuse an existing Kraken-related database.
   • If none exists, it auto-creates krakent project + krakent database (when SERENDB_AUTO_CREATE=true).
5. Copy config.example.json to config.json.
6. Install dependencies: pip install -r requirements.txt.
7. Optional publisher overrides:
   • KRAKEN_TRADING_PUBLISHER (default kraken-trading)
   • KRAKEN_TRADING_FALLBACK_PUBLISHER (default kraken-spot-trading)
   • Legacy alias: KRAKEN_SPOT_PUBLISHER (treated as fallback)

Commands

# Initialize SerenDB schema
python scripts/agent.py init-db

# Interactive recommendation flow
python scripts/agent.py recommend --config config.json --interactive

# Recommendation flow from JSON answers file
python scripts/agent.py recommend --config config.json --answers-file answers.json

Output

The agent returns:

• primary mode
• backup mode
• confidence score
• top reasons
• action checklist
• API-backed mode coverage
• session id for querying SerenDB history

Data Model (SerenDB)

Tables created by init-db:

• kraken_skill_sessions
• kraken_skill_answers
• kraken_skill_recommendations
• kraken_skill_actions
• kraken_skill_events

Notes

• This skill does not implement compliance policy logic. It routes user intent and lets Kraken API permissions enforce availability.
• The router only recommends modes backed by currently configured publishers.