# CoinGate MCP MCP > CoinGate MCP handles all cryptocurrency payment operations and fiat settlement for your business. Accept payments from global customers using multiple digital coins, instantly converting funds into usable local currency. You can programmatically create orders, monitor live balances, track payouts, and check real-time exchange rates—all through natural conversation. ## Overview - **Category:** finance-accounting - **Price:** Free - **Tags:** crypto-payments, fiat-settlement, payment-gateway, order-management, payouts, digital-assets ## Description Need to manage crypto revenue without logging into a dashboard? This MCP connects your CoinGate account directly to your AI agent, letting you handle payments and finance workflows just by talking. You can build out complex payment flows: list all pending orders, check the current BTC/USD rate, and then create a new order for immediate client use—all in one conversation. It’s like having a dedicated crypto operations manager who never gets tired of checking balances or tracking down transaction IDs. If your workflow involves money, risk is key. That's why Vinkius includes a financial circuit breaker with human-in-the-loop approval; you set the spending limit, and the AI cannot override it. This means you get full control over every single payment action without leaving your communication tool. ## Tools ### create_order Creates a new crypto payment order for a specified amount and currency. ### get_account_info Retrieves the current operational profile details of your connected CoinGate account. ### get_exchange_rates Fetches real-time exchange rates for major digital and fiat currencies. ### get_order Retrieves the full details for a single crypto payment order using its unique ID. ### list_orders Lists multiple active or past crypto payments, allowing you to check statuses in bulk. ### list_payouts Generates a list of all processed payouts and historical fund withdrawals from your account. ## Prompt Examples **Prompt:** ``` List all active payment orders in my CoinGate account. ``` **Response:** ``` I've retrieved your orders. You currently have 3 active transactions, including an order for 0.005 BTC (Status: Pending) and one for 150.00 EUR. Would you like the checkout URL for either of these? ``` **Prompt:** ``` What is the current BTC to USD exchange rate? ``` **Response:** ``` Scanning market... The current exchange rate for BTC/USD is $65,420.50. I've also checked the EUR rate, which is €60,150.00. Shall I check your payout history for these assets? ``` **Prompt:** ``` Create a new 50 EUR payment order titled 'Service Fee'. ``` **Response:** ``` Order created successfully! I've initialized the 50.00 EUR payment order for 'Service Fee'. The Order ID is 'ord_789'. You can share this checkout link with the client: [Payment URL]. ``` ## Capabilities ### Create Payment Orders Initialize a new crypto transaction order for a client or internal service fee. ### Monitor Account Status Retrieve your current CoinGate account details and verification status instantly. ### Fetch Real-Time Rates Get up-to-the-minute exchange rates for Bitcoin, Ethereum, and dozens of fiat/crypto pairs. ### Review Order Details Pull specific details on any single payment order using its ID number. ### List Transaction Batches View a paginated list of all active and past crypto payments, allowing bulk status checks. ### Manage Payout History Access and review complete records of historical payouts and fund withdrawals. ## Use Cases ### Reconciling a Week of Sales A financial analyst needs to reconcile last week's sales. They ask the agent to list_orders for the date range, then use get_exchange_rates on any discrepancies found before generating a summary report. ### Setting Up New Client Billing An ops manager needs to bill a new client immediately. They ask the agent to create_order for the service fee, which instantly generates a payment link that can be shared right away. ### Checking Fund Availability A developer is preparing for payroll runs and needs to know if enough funds are available. They ask the agent to list_payouts and get_account_info to verify balances before writing any code. ### Investigating a Failed Payment A merchant gets an alert about a suspicious payment. The agent can use get_order with the ID number to pull all associated metadata, helping them quickly resolve the issue. ## Benefits - Instant Status Checks: Need to know if a payment went through? Instead of digging through logs, use list_orders to check the status of multiple transactions in seconds. - Global Rate Intelligence: Don't guess at currency values. Use get_exchange_rates to pull real-time rates for BTC/USD or any pair before generating an order. - Automated Order Flow: Need a client to pay? The create_order tool lets you generate and send out payment links instantly, eliminating manual form filling. - Full Audit Trail: Never lose track of money. Use list_payouts to review all historical fund movements and reconcile balances with minimal effort. - Centralized Visibility: Check your current operational standing anytime by calling get_account_info—all without logging into the CoinGate dashboard. ## How It Works The bottom line is you use your natural language instructions to control complex financial actions without ever touching a web portal or copy-pasting an API key. 1. Subscribe to the CoinGate MCP on Vinkius. 2. Retrieve your API Token from your CoinGate dashboard (Settings > API). 3. Connect your AI client (Claude, Cursor, etc.) using that token. Your agent can now run payment operations. ## Frequently Asked Questions **How do I check my current crypto balance using the CoinGate MCP?** You use get_account_info to pull your operational profile details. This tool gives you a snapshot of your account's status without needing to log in. **What is the best way to list multiple payments with CoinGate MCP?** Use list_orders. You can filter these bulk requests by date range or status, letting you check activity for many transactions at once. **Can I use get_exchange_rates before creating a payment order?** Yes. Always call get_exchange_rates first to pull the most current market values. This prevents your client from paying an outdated rate when you run create_order. **Does list_payouts show my pending funds?** No, list_payouts shows historical payouts and confirmed fund withdrawals. For current balances, use get_account_info to see the active ledger status. **When using the `create_order` tool, how does it handle invalid payment data?** The function immediately throws a specific error and returns a detailed message. It won't attempt to create the order until you correct the JSON structure or missing required fields. This ensures your payment workflow stops safely. **What scope of information can I retrieve using the `get_account_info` tool?** You pull operational data like your merchant verification status, current API usage limits, and overall account profile details. This helps you monitor your system's health without logging into a web dashboard. **When I use the `get_order` tool, what detailed transaction information is provided?** The response delivers more than just status; it includes customer metadata, associated payout IDs, and the final settlement currency. This provides a complete audit trail for any single payment. **Can I filter the results of `list_orders` by date or specific status?** Yes, you must pass filters like start date, end date, and desired status codes within the request JSON. This limits the data returned, making it easy to find transactions from a specific period.