# Bitso Exchange MCP for AI Agents MCP > Bitso Exchange MCP connects your AI client directly to Mexico's leading crypto exchange for programmatic trading. You can execute limit and market buy/sell orders, check live account balances, monitor open positions, and track historical trades without using a web interface. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** crypto-exchange, fiat-pairing, portfolio-management, order-execution, liquidity-monitoring, wallet-tracking ## Description This connector lets you handle complex crypto trades by connecting your AI agent straight to the Bitso Exchange backend. Instead of refreshing charts or clicking through slow desktop applications, you simply instruct your agent what trade you want—whether it's placing a strict limit order or checking current liquidity on major pairs like BTC/MXN. You can pull live market ticker data and constantly verify available account capacity in fiat pools versus alt-coins natively within your prompt. All the heavy lifting, from reviewing historical executed trades to managing withdrawals, happens directly through conversation. This level of control lets you build truly algorithmic strategies right where they matter most. Because Vinkius manages this MCP, any compatible AI client—be it Cursor or Claude—gains immediate access to this entire suite of trading tools. ## Tools ### cancel_order Stops a live, unfulfilled trading order before it can execute. ### create_order Places a new buying or selling trade order on the exchange. ### get_account_status Retrieves information regarding regulatory account status and usage limits. ### get_funding_destination Shows the specific crypto address where incoming funds must be sent. ### get_ticker Fetches the current trading price and market details for any specified asset pair. ### list_available_books Lists all actively traded crypto market books available on the exchange. ### list_balances Provides a detailed breakdown of your current trading account balances across various assets. ### list_ledger Examines the raw, chronological flow of all activity recorded in your account ledger. ### list_open_orders Lists every active order that hasn't been filled or canceled yet. ### list_order_trades Extracts all executed trades specifically linked to a given Order ID. ### list_trades Reviews the full history of successfully executed crypto trades. ### list_withdrawals Monitors and reports on all funds that have been withdrawn from your account externally. ## Prompt Examples **Prompt:** ``` What's the current spread on the ETH/BRL pair? I want to know if we should place a buy order. ``` **Response:** ``` **Ethereum (ETH) / Brazilian Real (BRL)** * **Current Ticker:** $3,450.21 BRL * **Spread Status:** Active spread detected. * **24H Range:** Low: $3,380 | High: $3,510 The order book shows strong immediate buy interest at the current price point. Ready to check open orders? ``` **Prompt:** ``` I want to make 500 MXN worth of Bitcoin. Can you place a limit buy order? ``` **Response:** ``` Processing command: Limit Buy for BTC. ✅ **Order Submitted:** A new authenticated request was sent. * **Target Pair:** BTC/MXN * **Type:** Limit Buy (500 MXN value) * **Status:** Pending fulfillment on the exchange's Maker tab. You can check this order again using `list_open_orders`. ``` **Prompt:** ``` Show me all my trades and withdrawals from last month. ``` **Response:** ``` Here is your consolidated activity report: **💰 Withdrawals:** * 0.05 BTC (To External Wallet) * 1,500 MXN (Via SPEI System) **📈 Trades (Last 7 Days):** | Asset | Type | Quantity | Price | Total Value | | :---: | :---: | :---: | :---: | :---: | | ETH | Buy | 0.5 | $3,400 | 1,700 BRL | | XRP | Sell | 200 | N/A | Profit Confirmed | Your ledger is completely clear. ``` ## Capabilities ### Execute and manage crypto trades Submit new limit or market orders and cancel existing open positions on the exchange. ### Check account status and balances Retrieve your current trading account limits, verify available funds in different fiat pools, and list all asset holdings. ### Monitor market liquidity and prices Get real-time ticker information or list the active order books for specific crypto pairs. ### Review trade history and flows List all completed trades, monitor external withdrawals, and examine raw ledger account movements for full transparency. ## Use Cases ### Responding to sudden volatility The agent detects a rapid drop in BTC/MXN pairs. You instruct it to first run `list_open_orders` to see what's hanging, and then use `cancel_order` on the riskiest positions before suggesting a new market entry via `create_order`. ### Auditing a recent payment flow A partner asks about funds received. You ask your agent to run `list_withdrawals` and then check the raw activity using `list_ledger` to confirm the source of every dollar movement. ### Preparing for a large investment cycle Before making any major purchase, you first ask your agent to run `get_account_status` and `list_balances`. This confirms both that your account is compliant and that you have the necessary funds across all fiat pools. ### Comparative market research You want to compare multiple pairs. You ask the agent to use `get_ticker` on BTC/MXN, ETH/BRL, and USDC/ARS sequentially to get an immediate spread comparison before deciding where to trade. ## Benefits - Instantly manage your portfolio by using `create_order` to place limit or market orders without touching a web browser. This keeps your trading decisions happening in the chat window. - Gain total financial clarity with `list_balances`. You can instantly verify available fiat pools versus digital alt-coins right inside your prompt, eliminating manual dashboard checks. - Stay protected from bad trades using `cancel_order` and `list_open_orders`. If the market suddenly drops, you can tell your agent to drop an order immediately. - Deep dive into account movements by running `list_ledger`. You'll see a raw, undeniable record of every single credit and debit flow that happened on your account. - Monitor fund safety using `list_withdrawals` to track all external payouts. It gives you a clear view of where your money has gone this month. - Access real-time market depth with `get_ticker` or `list_available_books`, giving you the immediate data needed before any major trade. ## How It Works The bottom line is, your AI agent acts as your automated trading terminal, executing actions directly against the exchange's core systems. 1. Provide your isolated Read/Write Dev API Keys from Bitso to the MCP. 2. Tell your AI agent what action you want—for instance, 'Check my current BTC balance' or 'Place a limit buy order for ETH'. 3. The MCP executes the command against the exchange and returns the specific data point or confirmation of the transaction. ## Frequently Asked Questions **How do I use the Bitso Exchange MCP to check live crypto prices?** You ask your AI agent to retrieve the ticker for the specific pair you want (like BTC/MXN). It will return the last traded price, the current spread details, and the 24-hour trading range instantly. This gives you real-time market data without needing a browser. **Can I use this MCP to place an order if the market moves against me?** Yes. You can instruct your agent to monitor open orders using `list_open_orders` and then immediately cancel them with `cancel_order` if you see adverse movement, protecting your capital. **Does the Bitso Exchange MCP help me track money I took out of the exchange?** Absolutely. You can run a report on all executed withdrawals using `list_withdrawals`. This ensures you have a clear record of every fund transfer that left your account. **What if I want to see how much money I actually have in different currencies?** The MCP handles this by listing all your available balances using `list_balances`. It gives you a comprehensive breakdown of funds across every fiat pool and alt-coin, so you know exactly what you can spend. **Is the Bitso Exchange MCP only for experienced traders?** While it has advanced tools, you don't need to be a pro. You just need to ask simple questions like 'What is my balance?' or 'Should I buy this?' and let your agent handle the complex API calls in the background. **How do I check if an order I placed actually went through?** You can use `list_order_trades` with a specific Order ID to confirm every execution linked to that trade. It’s a direct way to verify the transaction history for peace of mind.