# Buenbit MCP MCP > Buenbit connects your crypto exchange account directly to any AI client. You can manage decentralized portfolios for Latin American markets by checking live asset prices, reading current balances, and executing buy or sell orders without touching a mobile app interface. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** crypto-exchange, defi, wallet, latin-america, argentina ## Description Managing crypto trades usually means juggling multiple tabs—checking rates on one site, logging into your wallet on another, and finally manually submitting an order form. This MCP changes that. It lets you talk to your AI agent about your portfolio like talking to a human analyst. You can ask it for the current price of BTC against ARS or check how much fiat is sitting in your account right now. If you want to place a limit buy order, you just tell your agent; it handles the submission and confirmation. It's all managed through a conversational layer that understands the nuances of LATAM crypto markets. This gives you direct control over complex operations without needing deep API knowledge, making Buenbit an invaluable piece of infrastructure available in the entire Vinkius catalog. ## Tools ### cancel_order Stops a pending cryptocurrency trade order before it gets filled. ### create_order Submits a new market or limit buy/sell trade request to the exchange. ### execute_withdrawal Sends out a crypto asset withdrawal to an external address. ### get_crypto_prices Reads universal spot conversion prices for any two crypto assets. ### get_deposit_address Retrieves the specific wallet address needed to receive incoming funds. ### get_network_fees Checks the current cost of network gas fees for transactions. ### get_ticker Gets the live, current market price ticker for a specific crypto pair (e.g., BTC/ARS). ### get_yield_rates Retrieves the current interest rates available in staking pools. ### list_assets Shows a full catalog of all crypto assets supported by the exchange. ### list_balances Lists the current amount and type of all funds held in your portfolio wallet. ### list_limits Checks the maximum trading limits set on your account profile. ### list_orders Displays a list of all orders you have placed, whether active or filled. ### list_transactions Retrieves a detailed record of money and crypto transactions that occurred on the account. ### list_withdrawals Shows a history of all crypto assets you have previously withdrawn. ## Prompt Examples **Prompt:** ``` Check the ticker for the BTC to ARS market pairing securely right now. ``` **Response:** ``` Ticker validated. The BTC/ARS pairing is trading with a Last Ask of $41M ARS and a Last Bid hovering smoothly around $40.5M. ``` **Prompt:** ``` Display my exact crypto availability looking at balances under my Buenbit portfolio. ``` **Response:** ``` Inspecting bounds. You hold `1.204 ETH`, `450.00 USDC`, and a small trace amount fiat standing natively at `50,000 ARS`. Let me know if you intend to initiate a market buy. ``` **Prompt:** ``` Instantly place a Limit Buy order. Spend around $30 USDC grabbing Bitcoin at roughly 68k edge margin. ``` **Response:** ``` Understood. Bypassing UI layers to submit `create_order` against 'btcusdc' natively. Limit Buy Order successfully pushed. Order ID `3029ab1-z` resting deeply on the book. Shall I review active orders list? ``` ## Capabilities ### Check real-time market prices Get instant, accurate spot rates for any crypto pair you need to trade. ### Review portfolio funds Read your current balances across all fiat and cryptographic assets in one go. ### Submit new trades Place sophisticated buy or sell limit orders without using the exchange's graphical user interface. ### Manage existing trades View, list, and cancel any pending or completed exchange order. ### Track asset movements Review a history of all deposits, withdrawals, and transactions that hit your account. ## Use Cases ### Confirming corporate fund transfers A financial officer needs to confirm if a large wire transfer hit the Buenbit account. They prompt their agent, asking it to use `list_transactions` and check for specific destination addresses to validate receipt before closing out the books. ### Setting up a complex trade strategy A quantitative trader wants to buy BTC but only if the rate is below $41M ARS. They first call `get_ticker` for confirmation, then use `create_order` with specific limit parameters, all in one sequence. ### Checking account limits before trading An investor wants to know if they can buy a large asset. They first run `list_limits` to see their profile constraints, then check their funds with `list_balances`, ensuring the trade is even possible. ### Handling a withdrawal failure The user needs to confirm if they already sent crypto and want proof. They ask the agent to use `list_withdrawals` to see the history, preventing them from sending duplicate funds. ## Benefits - Execute trades without the UI. Instead of navigating a clunky mobile app to place an order, you simply tell your agent what to buy and how much. This uses the `create_order` tool instantly. - Eliminate data hunting. You won't have to open three different tabs just to check prices; using `get_ticker` provides real-time rates for any pair directly in your chat window. - Confirm liquidity first. Before planning a move, run `list_balances`. This confirms you actually have the fiat or crypto available, preventing failed trades and lost time. - Audit trails are instant. Need to know if a deposit hit correctly? Use `list_transactions` for a full record, eliminating manual bank statement review. - Control your risk. You can list all open orders using `list_orders`, giving you an immediate overview of your current market commitments and exposure. ## How It Works The bottom line is you treat complex financial operations like simple conversations with your AI agent. 1. Connect the Buenbit MCP to your preferred AI client and input your API keys from the desktop trading panel. 2. Prompt your agent with a task, like 'What is the current BTC/ARS ticker?' or 'Show my USDC balance.' 3. The MCP executes the request by calling the necessary tool and returns actionable data directly into your conversation. ## Frequently Asked Questions **How do I check if my deposit was successful using list_transactions?** Yes, running `list_transactions` gives a full history of money and crypto movements. This lets you review the entire chain of events to confirm a specific deposit address matured successfully. **What is the difference between get_ticker and get_crypto_prices?** The `get_ticker` tool gives a live, immediate snapshot for one crypto pair (like BTC/ARS). The `get_crypto_prices` tool reads universal spot conversion rates across multiple asset types. **Can I cancel an order with the cancel_order tool?** Yes. If you placed a limit order and change your mind, calling `cancel_order` removes it from the book before it can be filled, saving you potential losses. **I need to withdraw crypto. Do I use execute_withdrawal?** Yes, using `execute_withdrawal` broadcasts a native withdrawal directly from your account. You should always confirm the destination address first by calling `get_deposit_address`. **How do I use `list_assets` to check which cryptocurrencies are currently available for trading?** The tool returns a comprehensive catalog of all supported crypto assets. Run this first if you need to confirm an obscure coin's ticker or symbol before building a complex trade strategy. **What is the best way to get my current deposit receiving address using `get_deposit_address`?** It provides the live, infrastructure wallet address for your selected network. Always pull this specific output when sending funds; never rely on saved addresses because they change. **Before I execute a trade, how do I check current gas costs using `get_network_fees`?** This function returns the up-to-date network fee estimate. Running this step prevents unexpected transaction failures or unnecessary spending when your agent attempts to deploy logic. **If my order status is unclear, how do I review all past trades using `list_orders`?** It pulls a history of every open and closed exchange order you have placed. This is critical for verifying specific order IDs or confirming if an attempted trade was actually logged on the book. **Is it safe to pass my Secret API Key to this agent?** Vurb explicitly executes locally unless connected through audited Edge channels. Setting `sensitive: true` physically hides your credentials. Be sure your Buenbit API scope restricts withdrawals to safeguard capital. **Do I need to generate an HMAC signature manually for trades?** No. The Server abstracts this. Simply instruct 'Buy 0.1 BTC at Limit' and the Agent utilizes the provided API Secret internally to digest and authenticate the packet. **How can I easily get my public deposit address for stablecoins?** Invoke `get_deposit_address` telling the LLM the desired symbol (e.g. `usdc`, `usdt`). It fetches the exact blockchain string address tied uniquely to your wallet profile.