# Kraken MCP > Kraken MCP gives your agent direct access to real-time crypto market data; you can pull current asset balances, check trade history, and analyze order book depth from both spot and futures markets. It's a full portfolio management suite built right into any AI client. ## Overview - **Category:** finance-accounting - **Price:** Free - **Tags:** cryptocurrency, bitcoin, trading, market-data, kraken-api ## Description Okay, so if you work with crypto, you know the drill: hopping between dashboards, opening browser tabs just to check a balance, or manually fetching historical price points for an analysis. That whole process is slow and it introduces friction—and bad data can cost real money. This MCP cuts that out entirely. It connects your agent directly to Kraken's API endpoints, so you don't need external logins or multiple screens. You simply ask your AI client for what you need—like the current price of ETH/USD and a summary of your available funds—and it runs the query itself. This Vinkius catalog connector handles everything from fetching granular asset pair information to running complex order book analysis (for futures trading). It just makes data retrieval conversational. ## Tools ### futures_get_history Retrieves a list of completed trade transactions for futures contracts. ### futures_get_orderbook Gets the current buy and sell depth (the order book) for specific futures pairs. ### futures_get_tickers Fetches real-time ticker information for various futures contracts. ### futures_send_order Allows you to submit a new trade order specifically for the futures market. ### spot_add_order Places a new trading limit or market order in the main spot market. ### spot_cancel_all_orders_after Cancels all orders placed after a specific date or time stamp, useful for cleanup. ### spot_cancel_all Cancels every single open order on your account at once. ### spot_cancel_order Removes a single, specified order from your account. ### spot_get_asset_pairs Lists all the distinct crypto pairs that are currently tradable on Kraken. ### spot_get_assets Provides general information about specific cryptocurrencies listed on the exchange. ### spot_get_balance Retrieves your current cash and crypto balances across your spot account. ### spot_get_closed_orders Fetches details on orders that have already been filled or canceled. ### spot_get_depth Displays the current buy/sell order book depth for spot trading pairs. ### spot_get_ledgers Retrieves detailed records of all ledger movements and transactions on your account. ### spot_get_ohlc Pulls historical Open, High, Low, Close data for charting purposes. ### spot_get_open_orders Shows all the active limit or market orders currently sitting in your open order book. ### spot_get_open_positions Lists assets that you currently hold a net position on. ### spot_get_spread Provides the recent price difference (the spread) between buy and sell prices for pairs. ### spot_get_system_status Checks Kraken’s overall system uptime and health status to ensure optimal trading conditions. ### spot_get_ticker Gets the latest, most basic price information for any supported crypto pair. ### spot_get_time Returns the current synchronized server time from Kraken. ### spot_get_trade_balance Retrieves your available balance specifically for executing trades. ### spot_get_trade_volume Calculates the total trading volume over a specified period. ### spot_get_trades_history Retrieves a comprehensive historical log of all your crypto trades. ### spot_get_trades Fetches a list of recent, executed trades in the spot market. ### spot_get_websockets_token Generates a temporary token needed to connect streaming web socket data. ### spot_query_orders Searches and reports on your order history, including both active and closed orders. ### spot_query_trades Queries a detailed log of trade activity based on specific criteria. ## Prompt Examples **Prompt:** ``` What is the current market price and 24h volume for Ethereum (ETH/USD)? ``` **Response:** ``` I've checked the Kraken ticker for XETHZUSD. The last trade was at $2,450.20 with a 24-hour volume of 15,420 ETH. The current spread is $0.10. ``` **Prompt:** ``` Show me my current Kraken account balances. ``` **Response:** ``` Fetching your balances... You currently hold 0.5 BTC, 10 ETH, and 5,000 USD in your spot account. ``` **Prompt:** ``` Check if there are any open orders on my account. ``` **Response:** ``` I found one open limit order to sell 0.1 BTC at $70,000. It is currently 'open' and has not been partially filled yet. ``` ## Capabilities ### Retrieve current account status Check your total spot and trade balances, or list open and closed orders across your entire Kraken account. ### Analyze market depth and pricing Get real-time ticker information, the full order book for futures contracts, and historical OHLC data for backtesting models. ### Manage trading activity Send new orders or cancel existing positions (both spot and futures) directly through your agent's workflow. ### Discover tradable assets Query the full list of available asset pairs, helping you identify markets that haven't been analyzed yet. ## Use Cases ### Need to compare spot vs. futures risk. A user needs to model a potential trade; they ask their agent to check the `spot_get_balance` first, then use `futures_get_orderbook` for pricing depth, and finally execute a hypothetical order using `futures_send_order`. The whole sequence happens in one chat session. ### Investigating why an old trade failed. The user asks the agent to check their account status. The agent executes `spot_get_ledgers`, providing a granular, transaction-by-transaction report that pinpoints exactly where the funds went wrong. ### Performing rapid market analysis. A financial analyst needs quick data points for a presentation. They use the agent to call `spot_get_ticker` multiple times, gathering real-time prices and calculating spreads using `spot_get_spread`, all in under a minute. ### Cleaning up old test orders. A developer finishes testing a pair of assets. They use the agent to call `spot_query_orders` to find all relevant IDs, then run `spot_cancel_all_orders_after` on the test date, ensuring nothing is left open. ## Benefits - Check account balances instantly. Instead of navigating to a separate 'Balances' tab, you just ask for it; the agent runs `spot_get_balance` immediately. - Track full trading activity. You can get both recent trades (`spot_get_trades`) and a deep history (`spot_get_trades_history`), all without switching applications. - Run complex market simulations. Pulling historical OHLC data via `spot_get_ohlc` lets you model price action directly in your agent's workspace, which is way faster than CSV exports. - Execute trades and manage risk from one prompt. You can use `spot_add_order` to place a bet, or immediately follow up with `spot_cancel_order` if the market shifts unexpectedly. - View system health on demand. Use `spot_get_system_status` to confirm that Kraken is actually operational before running any high-stakes query (a necessary sanity check). - Understand liquidity depth. Accessing the order book (`spot_get_depth`) lets you see exactly where the current buy and sell pressure lies, which is critical for serious trading. ## How It Works The bottom line is that your AI client handles all the API calls; you just type what you want to know or do. 1. First, subscribe to this MCP and provide your required Kraken API Key and Secret; (this is necessary because the tool needs authenticated access). 2. Next, prompt your AI client with a specific request—for example, 'What's the 24-hour volume for BTC/USD?' 3. The agent executes the appropriate function call through this MCP, retrieves the raw market data, and formats it back to you in plain text. ## Frequently Asked Questions **How do I get historical price data using spot_get_ohlc?** You just ask the agent for it. You don't need to manually construct endpoints or worry about date formats; tell it the asset and time frame, and `spot_get_ohlc` handles the rest. **Can I use futures_send_order with this MCP?** Yes. You can send orders for futures contracts using `futures_send_order`. This keeps your spot and derivatives trading actions organized in one place, which is pretty convenient. **What's the difference between spot_get_depth and spot_get_ohlc?** `spot_get_depth` shows you the immediate buy/sell pressure (the current order book), while `spot_get_ohlc` gives you historical price points over time, which is better for charting. **Is there a tool to check if my account has money?** Yes. Use `spot_get_balance` or `spot_get_trade_balance`. They both give you the current cash availability, but one is more generalized than the other. **How do I list all my orders?** You can use `spot_query_orders` to get a comprehensive overview of your order status, or if you just want active ones, use `spot_get_open_orders`. **What should I use with `spot_get_system_status` to confirm optimal trading conditions?** You use this tool to verify the operational readiness of Kraken. It checks core system metrics, ensuring that the platform is running normally and that time synchronization is accurate for your trades. **How do I discover all available assets and pairs using `spot_get_asset_pairs`?** The tool returns a comprehensive list of every asset pair currently tradable on the spot market. Use this output to select the specific symbols you need before attempting any price or order book queries. **If I need detailed financial records, how do I check my movement history using `spot_get_ledgers`?** This function retrieves a complete audit log of your account movements. Unlike trade history, ledgers detail deposits, withdrawals, and fee structures, giving you a full accounting view. **How can I check the current price of Bitcoin against USD?** You can use the `spot_get_ticker` tool. Simply provide the asset pair, such as `{"pair": "XXBTZUSD"}`, and the agent will return the latest bid, ask, and last trade prices. **Is it possible to see my total account balance across all currencies?** Yes! The `spot_get_balance` tool retrieves your full account balance. Your AI agent will list each asset you hold and its corresponding amount. **Can I monitor my active limit orders using this server?** Absolutely. Use the `spot_get_open_orders` tool to fetch a list of all currently active orders, including their status, volume, and price details.