CryptoAPIs MCP Prepare Transactions

servidor MCP para construir transacciones no firmadas en múltiples blockchains a través de Crypto APIs

Documentación

@cryptoapis-io/mcp-prepare-transactions

Servidor MCP para el producto Prepare Transactions de Crypto APIs. Construye transacciones EVM sin firmar para transferencias de monedas nativas, transferencias de tokens fungibles y transferencias de NFT.

Versión de API: Compatible con la versión 2024-12-12 de Crypto APIs

Características

  • Prepara transacciones de transferencia de monedas nativas (desde una dirección)
  • Prepara transacciones de transferencia de tokens fungibles (ERC-20)
  • Prepara transacciones de transferencia de NFT (ERC-721)
  • Devuelve el hex de la transacción sin firmar, listo para firmar con @cryptoapis-io/mcp-signer

Requisitos previos

Instalación

npm install @cryptoapis-io/mcp-prepare-transactions

O instala todos los servidores MCP de Crypto APIs: npm install @cryptoapis-io/mcp

Uso

# Run with API key
npx @cryptoapis-io/mcp-prepare-transactions --api-key YOUR_API_KEY

# Or use environment variable
export CRYPTOAPIS_API_KEY=YOUR_API_KEY
npx @cryptoapis-io/mcp-prepare-transactions

# HTTP transport
npx @cryptoapis-io/mcp-prepare-transactions --transport http --port 3000 --api-key YOUR_API_KEY

Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "cryptoapis-prepare-transactions": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-prepare-transactions"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Añade a .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "cryptoapis-prepare-transactions": {
      "command": "npx",
      "args": ["-y", "@cryptoapis-io/mcp-prepare-transactions"],
      "env": {
        "CRYPTOAPIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP Inspector

npx @modelcontextprotocol/inspector npx @cryptoapis-io/mcp-prepare-transactions --api-key YOUR_API_KEY

n8n

  1. Inicia el servidor en modo HTTP:
    npx @cryptoapis-io/mcp-prepare-transactions --transport http --port 3000 --api-key YOUR_API_KEY
    
  2. En tu flujo de trabajo de n8n, añade un nodo AI Agent
  3. En Tools, añade una MCP Client Tool y establece la URL en http://localhost:3000/mcp

Todos los servidores usan el puerto 3000 por defecto. Usa --port para asignar puertos diferentes al ejecutar varios servidores.

Herramientas Disponibles

prepare_transactions_evm

Prepara transacciones EVM sin firmar.

AcciónDescripción
prepare-transaction-from-addressPrepara una transferencia de moneda nativa desde una dirección
prepare-fungible-token-transferPrepara una transferencia de token ERC-20
prepare-nft-transferPrepara una transferencia de NFT ERC-721

Argumentos de CLI

ArgumentoDescripciónPredeterminado
--api-keyClave de API de Crypto APIsvariable de entorno CRYPTOAPIS_API_KEY
--transportTipo de transporte: stdio o httpstdio
--hostHost HTTP0.0.0.0
--portPuerto HTTP3000
--pathRuta HTTP/mcp
--statelessHabilita el modo HTTP sin estadofalse

Modos de Clave de API HTTP

Al usar transporte HTTP, el servidor admite dos modos de clave de API:

  • Con --api-key: La clave se usa para todas las solicitudes. Los encabezados de solicitud x-api-key se ignoran.
  • Sin --api-key: Cada solicitud debe incluir un encabezado x-api-key con una clave válida de Crypto APIs. Esto permite alojar un servidor público donde cada usuario proporciona su propia clave.
# Per-request key mode (multi-tenant)
npx @cryptoapis-io/mcp-prepare-transactions --transport http --port 3000
# Clients send x-api-key header with each request

El transporte Stdio siempre requiere una clave de API al iniciar.

Importante: Clave de API Obligatoria

Advertencia: Realizar solicitudes sin una clave de API válida — o con una incorrecta — puede resultar en el bloqueo de tu IP en el ecosistema de Crypto APIs. Asegúrate siempre de tener una clave de API válida configurada antes de iniciar cualquier servidor.

Servidor MCP Remoto

Crypto APIs proporciona un servidor MCP remoto oficial con todas las herramientas disponibles mediante transporte HTTP Streamable en https://ai.cryptoapis.io/mcp. Pasa tu clave de API mediante el encabezado x-api-key — no se requiere instalación.

Licencia

MIT