# Infini Payment MCP Server

A Model Context Protocol (MCP) server built on the [Infini Payment API](https://developer.infini.money/docs/) that provides cryptocurrency payment processing capabilities.

## Features

- ✅ **Complete Order Management**: Create, query, list, and reissue tokens
- ✅ **Fund Withdrawal**: Multi-chain withdrawal support
- ✅ **Currency Support**: Get supported cryptocurrency list
- ✅ **Webhook Verification**: Verify callback notification signatures
- ✅ **HMAC-SHA256 Authentication**: Compliant with Infini official signature specifications
- ✅ **Environment Switching**: Support for sandbox and production environments

## Quick Start

### 1. Install Dependencies

```bash
uv sync
```

### 2. Configure Environment Variables

Copy the environment template:

```bash
cp .env.example .env
```

Edit the `.env` file and fill in your Infini API credentials:

```bash
INFINI_API_KEY=your_api_key_here
INFINI_SECRET_KEY=your_secret_key_here
INFINI_ENV=sandbox  # or production
```

### 3. Run the Server

```bash
uv run server.py
```

## Connect to Infini's MCP Server

### Cursor

To add Infini MCP to Cursor, add the following to your `~/.cursor/mcp.json` file:

```json
{
  "mcpServers": {
    "infini": {
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/Users/yanbo/infini-mcp"
    }
  }
}
```

To learn more, see the [Cursor documentation](https://docs.cursor.com/).

### VS Code

To add Infini MCP to VS Code, add the following to your `.vscode/mcp.json` file in your workspace:

```json
{
  "servers": {
    "infini": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/Users/yanbo/infini-mcp"
    }
  }
}
```

To learn more, see the [VS Code documentation](https://code.visualstudio.com/docs/).

### Claude Code

To add Infini MCP to Claude Code, run the following command:

```bash
claude mcp add --transport stdio infini uv run server.py
```

To learn more, see the [Claude Code documentation](https://claude.ai/code).

### ChatGPT

To add Infini MCP to ChatGPT, you need to configure it through the ChatGPT interface:

1. Go to Settings > Beta features > MCP Servers
2. Click "Add MCP Server"
3. Select "Local Server"
4. Enter the command: `uv run server.py`
5. Set the working directory: `/Users/yanbo/infini-mcp`

## Available Tools

### Order Management

#### `create_payment_order`
Create a new payment order

**Parameters:**
- `request_id` (str, required): Unique request ID
- `amount` (str, required): Order amount
- `client_reference` (str, optional): Client reference
- `order_desc` (str, optional): Order description
- `merchant_alias` (str, optional): Custom merchant alias
- `expires_in` (int, optional): Expiration time in seconds, 0 for default
- `success_url` (str, optional): Success callback URL
- `failure_url` (str, optional): Failure callback URL

**Returns:** Order details including `order_id` and `checkout_url`

#### `get_payment_order`
Query order details

**Parameters:**
- `order_id` (str, required): Order ID

#### `list_payment_orders`
Get order list

**Parameters:**
- `currency` (str, optional): Currency filter (USDC/USDT)
- `status` (str, optional): Status filter
- `page` (int, optional): Page number, default 1
- `page_size` (int, optional): Page size, default 10

#### `reissue_order_token`
Reissue checkout URL token

**Parameters:**
- `order_id` (str, required): Order ID

### Currency and Funds

#### `get_supported_currencies`
Get supported cryptocurrency list

#### `withdraw_funds`
Withdraw funds to external wallet

**Parameters:**
- `chain` (str, required): Blockchain network
- `token_type` (str, required): Token type
- `amount` (str, required): Withdrawal amount
- `wallet_address` (str, required): Destination wallet address
- `note` (str, optional): Note

### Webhook Verification

#### `verify_webhook_signature`
Verify webhook notification signature

**Parameters:**
- `body` (str, required): Webhook request body
- `signature` (str, required): Signature
- `timestamp` (str, required): Timestamp
- `webhook_secret` (str, optional): Webhook secret

## Error Handling

The server automatically handles common HTTP errors including:

- **400**: Request parameter errors
- **401**: Authentication failure
- **403**: Insufficient permissions
- **404**: Resource not found
- **409**: Business conflicts
- **500**: Internal server errors

## Test Environment

### Test Network

Currently supports **Tron Testnet (Nile)** for testing:

- **Chain**: Tron Testnet
- **Token**: USDT (test coins)
- **Wallet**: TronLink
- **Faucet**: https://nileex.io/join/getJoinPage

### Test Bank Card

Test card number: **4000000000000085** (test environment only)

## Security Tips

1. **Key Security**: API keys and secrets must be securely stored, never expose to frontend
2. **Request Idempotency**: Use globally unique `request_id` to ensure idempotency
3. **Rate Limiting**: Default 600 requests per minute per API Key
4. **Time Synchronization**: Ensure server time accuracy (±300 seconds)

## Development Notes

### Signature Algorithm

This implementation strictly follows Infini official signature specifications:

**Request without Body (GET):**
```
{keyId}
{METHOD} {path}
date: {GMT_time}
```

**Request with Body (POST):**
```
{keyId}
{METHOD} {path}
date: {GMT_time}
digest: SHA-256={body_digest_base64}
```

### Webhook Signature

Webhook uses `timestamp + body` for signature verification.

## Support and Contact

For issues, please refer to [Infini Official Documentation](https://developer.infini.money/docs/) or contact technical support.

## LICENSE
GNU AFFERO GENERAL PUBLIC LICENSE V3.0