# MNEE MCP Server

A Model Context Protocol (MCP) *streamHttp* server for interacting with MNEE stablecoin on Bitcoin SV. This server enables AI agents to check balances, transfer tokens, and query transaction history.

## Features

- Check MNEE balance for any address
- Transfer MNEE tokens (requires wallet configuration)
- Get transaction history and UTXOs
- Query fee tiers and token configuration
- Supports sandbox and production environments

## Available MCP Tools

| Tool | Description | Auth Required |
|------|-------------|---------------|
| `get_my_wallet_address` | Get current user's wallet address | Yes |
| `check_balance` | Check MNEE balance for a Bitcoin address | Yes |
| `transfer` | Transfer MNEE tokens to a recipient | Yes |
| `check_tx_status` | Check transaction status by ticketId | Yes |
| `get_utxos` | Get UTXOs for an address (paginated) | Yes |
| `get_tx_history` | Get recent transaction history | Yes |
| `get_fee_tiers` | Get transaction fee tiers | Yes |
| `get_token_config` | Get MNEE token configuration | Yes |
| `get_special_addresses` | Get fee, burn, and mint addresses | Yes |
| `get_approver_key` | Get approver public key | Yes |


## Using MCP Server in MNEE Agent Dashboard
MCP Tools are automatically integrated in agent chats in [MNEE Agent Dashboard](https://mnee-agent.vercel.app) , you do not need additional configuration for MCP server configuration

## Connecting MCP Server via external Desktop/AI tool

### Get Your API Token

1. Go to [MNEE Agent Dashboard](https://mnee-agent.vercel.app)
2. Navigate to your account settings
3. Copy your API token

### Configure Your MCP Client

#### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mnee": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://qilin-mcp-mnee.vercel.app/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN"
      ]
    }
  }
}
```

#### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "mnee": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://qilin-mcp-mnee.vercel.app/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN"
      ]
    }
  }
}
```


## Tool Examples

### Check Balance

```json
{
  "tool": "check_balance",
  "arguments": {
    "address": "1G6CB3Ch4zFkPmuhZzEyChQmrQPfi86qk3",
    "environment": "sandbox"
  }
}
```

### Transfer MNEE

```json
{
  "tool": "transfer",
  "arguments": {
    "toAddress": "1RecipientAddress...",
    "amount": 10.5,
    "environment": "sandbox"
  }
}
```

### Get Transaction History

```json
{
  "tool": "get_tx_history",
  "arguments": {
    "address": "1G6CB3Ch4zFkPmuhZzEyChQmrQPfi86qk3",
    "limit": 5,
    "environment": "sandbox"
  }
}
```

## Testing

Use the MCP Inspector to test your server:

```bash
npx @modelcontextprotocol/inspector
```

## Environment Options

All tools support an `environment` parameter:
- `sandbox` (default) - Test environment
- `production` - Live environment

## License

See [LICENSE](./LICENSE) for details.