kraken-signals-mcp

Kraken Signals MCP

Wire Kraken Crypto Signals into Claude Desktop, Cursor, or any MCP client as tools. Ask your agent for a signal and it calls the tool; for the paid tools the bridge pays USDC on Base automatically via x402 and returns the result.

The get_signal_preview tool is free and needs no wallet key. The other tools cost a few cents per call and activate only when you set a Base wallet key.

Quick start (no clone, no build)

Add this to your client config and you're done — npx fetches and runs it:

Claude Desktop — Settings → Developer → Edit Config:

{
  "mcpServers": {
    "kraken-signals": {
      "command": "npx",
      "args": ["-y", "kraken-signals-mcp"]
    }
  }
}

That gives you the free preview out of the box. To enable the paid tools, add a low-balance Base wallet key:

{
  "mcpServers": {
    "kraken-signals": {
      "command": "npx",
      "args": ["-y", "kraken-signals-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<your-low-balance-base-wallet-private-key>"
      }
    }
  }
}

Cursor — Settings → MCP → Add new server, same command/args/env.

Restart the client, then ask: "Get the BTC signal preview" (free) or "Get the top crypto signals right now" (paid).

Tools

Tool	Cost	Description
get_signal_preview	free	Current BTC/USD direction (BUY/SELL/HOLD), no wallet key required
get_signal	$0.01 USDC	Signal + confidence for one pair (any Kraken */USD)
get_top_signals	$0.10 USDC	Market scan — strongest signals across major pairs
get_history	$0.05 USDC	Revealed historical signal snapshots (commit-reveal) + verifiable hashes
get_regime_changed	$0.02 USDC	Market regime (RISK_ON/RISK_OFF) + whether it changed since you last looked
get_backtest	$0.25 USDC	Walk-forward replay: win-rate + avg forward return per BUY/SELL signal
get_indicators	$0.005 USDC	Atomic TA indicators (RSI, EMA, MACD, ATR, Bollinger, volume) for a pair/timeframe

Paid mode (optional)

The paid tools need an EVM_PRIVATE_KEY: a Base wallet private key for a low-balance, dedicated hot wallet holding a little USDC — never your main wallet. Payments are gasless for the payer (the facilitator covers gas), so you mainly need a small USDC balance. Without the key, paid tools return a clear "set EVM_PRIVATE_KEY" message and the free preview keeps working.

RESOURCE_SERVER_URL is optional and defaults to https://signals.nsgoods.org.

Run from source (dev)

cd mcp
npm install
npm run build
node dist/server.js   # or: npm run dev

Security

• The EVM_PRIVATE_KEY is yours (the buyer's) and stays local in your client config — it is never sent to the API. Use a throwaway hot wallet with only a small USDC balance.
• For spend control, see the policy-check hooks in the official x402 MCP guide and cap per-call / per-session amounts.

Notes

Mirrors the official x402 MCP client pattern: https://docs.x402.org/guides/mcp-server-with-x402 . The x402 v2 TypeScript packages (@x402/axios, @x402/evm) evolve quickly — if npm install or the build fails, check that guide for current package names/versions.

No accounts, no API keys on the service side. Educational signals — not financial advice. MIT licensed.