# MCP Peppermint Server

Un servidor Model Context Protocol (MCP) para la API de Peppermint Tools. Proporciona acceso completo a funcionalidades blockchain incluyendo contratos inteligentes, tokens, NFTs y más.

## Características

- **18 herramientas MCP** para operaciones blockchain
- **Autenticación flexible**: Plain API Key (recomendada) y HMAC-SHA512
- **Operaciones completas**: Blockchains, contratos, tokens, vaults, transacciones
- **Auto-configuración**: Detecta vaults automáticamente

## Instalación

```bash
npm install
npm run build
```

## Configuración

### Variables de entorno:
- `PEPPERMINT_API_KEY`: Tu API key de Peppermint
- `PEPPERMINT_INSECURE_KEY`: `"1"` para Plain API Key, `"0"` para HMAC

### Para Claude Desktop:

```json
{
  "mcpServers": {
    "peppermint": {
      "command": "node",
      "args": ["/ruta/completa/al/proyecto/dist/flexible-server.js"],
      "env": {
        "PEPPERMINT_API_KEY": "tu-api-key",
        "PEPPERMINT_INSECURE_KEY": "1"
      }
    }
  }
}
```

## Uso

```bash
# Ejecutar servidor
npm start

# Desarrollo
npm run dev
```

## Herramientas Disponibles

### Información
- `get_auth_info` - Ver método de autenticación actual

### Blockchain
- `list_blockchains` - Listar blockchains disponibles
- `get_blockchain` - Obtener detalles de blockchain

### Contratos
- `list_contracts` - Listar contratos
- `get_contract` - Obtener contrato específico
- `deploy_contract` - Desplegar contrato
- `read_contract` - Leer datos de contrato
- `write_contract` - Escribir datos a contrato

### Tokens
- `create_token` - Crear token ERC20
- `mint_token` - Mint tokens
- `burn_token` - Burn tokens
- `transfer_erc20` - Transferir tokens ERC20 desde un wallet

### Vaults
- `list_vaults` - Listar vaults
- `get_vault` - Obtener vault específico
- `create_vault` - Crear vault

### Transacciones
- `list_transactions` - Listar transacciones
- `get_transaction` - Obtener transacción específica

### Wallets
- `create_wallet` - Crear wallet

## Estructura del Proyecto

```
src/
├── flexible-server.ts    # Servidor MCP principal
├── flexible-client.ts    # Cliente API de Peppermint
├── flexible-auth.ts      # Sistema de autenticación
└── types.ts             # Definiciones de tipos
```

## Licencia

ISC