# CoinGate MCP MCP

> CoinGate connects your crypto payments operations directly to any AI client. It lets you manage funds, place new cryptocurrency orders, check real-time exchange rates (Bitcoin, Ethereum, and dozens more), and monitor payouts—all through natural conversation. Stop switching between payment dashboards; handle every financial workflow from one chat window.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** crypto-payments, fiat-settlement, payment-gateway, order-management, payouts, digital-assets

## Description

Managing payments across different currencies and blockchains used to mean logging into multiple portals or running complex manual queries on a blockchain explorer. Now you can talk to your AI agent about your crypto finances, and it handles the rest. You tell it what you need—say, 'I need an order for 100 EUR'—and it initiates the transaction. It doesn't just create the payment; it gives you visibility into current balances, tracks pending orders, and even pulls up historical payout records. This centralized view means your AI acts like a dedicated finance coordinator, eliminating manual address checking or digging through complex data sets. Through Vinkius, this MCP makes cryptocurrency payments accessible to any client, giving developers and financial teams true control over their digital asset operations.

## Tools

### create_order
This tool generates a new cryptocurrency payment order for your merchants.

### get_account_info
Retrieves the current details and profile information for your CoinGate account.

### get_order
Provides detailed information on a single, specific payment order ID.

### get_exchange_rates
Fetches up-to-the-minute exchange rates between various digital and fiat currencies.

### list_orders
Lists all crypto payment orders associated with your account for review.

### list_payouts
Shows a comprehensive list of all historical payout transactions in your system.

## 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

### Initiate New Payments
You can create a new crypto payment order using specific currency amounts and titles.

### Get Account Status
Check your overall account profile details, including verification status.

### Review Order History
List all past and current crypto payment orders to see their statuses and amounts.

### Manage Payout Records
Access a full history of payouts and monitor your account balances efficiently.

### Check Currency Rates
Retrieve the current exchange rates for Bitcoin, Ethereum, and many fiat currencies in real-time.

## Use Cases

### A merchant needs to check payment viability for a new client.
The agent runs `get_exchange_rates` first, confirming the current EUR/USD rate. Then, it uses that data to call `create_order`, generating an immediate checkout link for the client and giving the merchant confidence in the transaction.

### An accountant needs a quarterly financial audit.
The agent runs `list_payouts` followed by `get_account_info`. This gives the analyst both the historical payout data and current balance metrics, allowing them to build a complete picture of fund movement without manually exporting CSV files.

### A developer needs to validate an order status for a script.
Instead of building complex webhook listeners, the agent runs `list_orders` and then uses `get_order` on a specific ID. This confirms if the payment has moved from 'Pending' to 'Completed,' which is crucial for triggering downstream actions.

### A manager needs to reconcile multiple pending payments.
The agent executes `list_orders` and pulls up a summary of all transactions. For any order requiring more detail, the manager can ask it to run `get_order`, confirming exactly what was purchased and who initiated it.

## Benefits

- Instant visibility into order status. Instead of manually checking an explorer, use `list_orders` to see all active and completed transactions in one query.
- Keep track of funds easily. Use `list_payouts` to review your payout history and monitor account balances without logging into a dedicated accounting dashboard.
- Real-time market intelligence. Get the latest rates for BTC, ETH, and dozens of fiat currencies using `get_exchange_rates`, so you know the true value before placing an order.
- Streamlined checkout process. Initiate payments instantly by calling `create_order` with just a few natural language commands, generating a shareable link right away.
- Comprehensive account overview. Use `get_account_info` to quickly confirm your operational status and view core profile details before starting any workflow.

## How It Works

The bottom line is that your AI agent handles the complex API calls and presents you with a simple, conversational answer, letting you manage everything without code.

1. Subscribe to this MCP on Vinkius and retrieve your API Token from the CoinGate dashboard.
2. Connect the token to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a question—like 'What's the BTC/USD rate?' or 'List all open orders.' The AI executes the request directly.

## Frequently Asked Questions

**How do I list all payments using the list_orders tool?**
You simply ask your agent to run `list_orders`. It compiles a complete list of every payment order linked to your account, making it easy to see what's active and what's finished.

**Can I check the current rates using get_exchange_rates?**
Yes. Calling `get_exchange_rates` retrieves real-time data for major digital and fiat currency pairs, giving you up-to-the-minute market values.

**How do I make a new order using create_order?**
You instruct the agent to run `create_order`, providing the necessary details like the amount and the title. The tool handles the creation and gives you an immediate checkout link.

**Does list_payouts show failed payments?**
The `list_payouts` tool provides a history of transactions, so it shows both successful payouts and records that indicate where funds did not settle or were returned.

**How do I verify my operational status using the get_account_info tool?**
The `get_account_info` tool provides your current profile details, including critical verification status flags. This lets you know instantly if there are any restrictions on payouts or transaction limits based on your account's completeness.

**If I know the Order ID, how do I pull all payment details using get_order?**
Use `get_order` and provide the specific order identifier. This action returns a detailed snapshot of that single transaction, including its precise status, associated metadata, and final settlement information.

**What data must I include in the JSON when I call create_order?**
The `create_order` tool requires a structured JSON string containing all necessary payment parameters. You must accurately provide the desired amount, currency code, and title for the order to initialize successfully.

**What is the functional difference between list_orders and list_payouts?**
`list_orders` tracks payments you initiated or are pending funds for. In contrast, `list_payouts` specifically lists records of actual withdrawal transactions that have been completed into your account.

**How do I find my CoinGate API Token?**
Log in to your account, navigate to the **API** section in your dashboard, and generate a new Bearer Token for your integration.

**Which cryptocurrencies are supported for payments?**
CoinGate supports Bitcoin (BTC), Ethereum (ETH), Litecoin (LTC), and many other digital assets, plus major fiat currencies.

**Can the agent check real-time exchange rates?**
Yes! The `get_exchange_rates` tool retrieves the most current market rates for all supported assets in the CoinGate ecosystem.