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