Modexia-mcp

¡Claro! Aquí tienes la traducción al español del documento Markdown, preservando todos los placeholders y la estructura:

--- name: modexia-mcp version: 0.4.1 description: El servidor oficial del Protocolo de Contexto de Modelo (MCP) para que Agentes de IA autónomos interactúen con la infraestructura criptográfica de Modexia. author: Modexia homepage: https://github.com/Modexia/ModexiaAgentpay tags: - mcp - web3 - payments avatar: https://raw.githubusercontent.com/Modexia/ModexiaAgentpay/main/apps/mcp-server/assets/modexialogo.png config: type: stdio command: uvx args: - modexia-mcp skills: - nanopay - nanopay_activate - nanopay_deposit - nanopay_withdraw - nanopay_balance - submit_intent - get_intent - list_intents - open_channel - consume_channel - settle_channel - get_channel - list_channels - get_balance - get_history - transfer - cross_chain_transfer - smart_fetch prompts: - nanopay_usage_instruction - create_intent_payment_instruction - setup_microtransactions_instruction - create_payment_instruction resources: - modexia://docs/llms_context --- [](https://lobehub.com/mcp/modexia-modexia-mcp)

Bienvenido al Servidor MCP de Modexia AgentPay (modexia-mcp). Este servidor tiende un puente entre los Modelos de Lenguaje Grande y la economía digital del mundo real.

Al integrar este servidor estándar del Protocolo de Contexto de Modelo (MCP) en tu stack de IA (Claude Desktop, LobeChat, Dify o enjambres multi-agente personalizados), equipas instantáneamente a tus Agentes de IA con una Billetera de Contrato Inteligente programable.

En lugar de que tus agentes encuentren errores de 402 Payment Required y fallen, ahora pueden negociar paywalls de forma autónoma, comprar datos premium, ejecutar microtransacciones sin gas a través de Circle Gateway y comerciar recursos computacionales con otros agentes en canales de vault de alta frecuencia.

Modexia le da a tu IA una cuenta bancaria, y MCP le da las herramientas para usarla.

---

Novedades en v0.4.1

Nanopagos Circle Gateway (x402) Esta versión incorpora soporte agéntico completo para microtransacciones sin gas y de fracciones de centavo directamente a nivel de MCP.

• nanopay — Obtén una URL protegida por x402 y negocia automáticamente el pago usando firmas offline EIP-3009. Incluye lógica de recarga automática integrada.
• nanopay_activate — Activación única para el agente.
• nanopay_deposit / nanopay_withdraw — Gestiona los fondos del gateway directamente desde la billetera principal.
• nanopay_balance — Consulta el Saldo Disponible Real (depósitos del gateway menos firmas pendientes/no liquidadas).
• Manejo Estructurado de Errores — Las herramientas MCP ahora devuelven códigos ModexiaPaymentError estructurados (p. ej., INSUFFICIENT_MAIN_BALANCE) para que el LLM pueda razonar sobre los fallos y tomar acciones correctivas.

---

Anterior: Novedades en v0.3.0 (Intención de Pago)

Pagos Basados en Intención (v2) Ejecuta pagos USDC estándar a través de un pipeline de cumplimiento estricto con retroalimentación enriquecida.

• submit_intent — Crea una intención firmada, valídala contra las políticas y ejecútala en cadena.
• get_intent / list_intents — Rastro de auditoría y seguimiento.

---

Características

• Integración con Circle Gateway: Acceso programático directo a la infraestructura de nanopagos USDC de Circle.
• Microtransacciones sin Gas: Envía pagos desde $0.000001 con cero comisiones de blockchain.
• Firmas Offline EIP-3009: Autorizaciones de pago seguras fuera de cadena que previenen el doble gasto.
• Enrutamiento Basado en Intención: Aplicación estricta de políticas, límites de gasto diarios y rastros de auditoría criptográficos.
• Negociación Automatizada de Paywalls: Detecta automáticamente los encabezados 402 Payment Required y cúmplelos en línea.
• Recarga Automática Inteligente: Recarga sin problemas los saldos del gateway desde la billetera principal cuando los fondos se agotan.

---

Componentes MCP Expuestos

Herramientas

Nombre de la Herramienta	Descripción
nanopay	Negocia y paga automáticamente URLs 402 Payment Required usando firmas offline EIP-3009.
nanopay_activate	Comando de activación única para habilitar nanopagos Circle Gateway para el agente.
nanopay_deposit	Deposita fondos desde la billetera principal del agente al Gateway de nanopagos.
nanopay_withdraw	Retira fondos no utilizados del Gateway de vuelta a la billetera principal.
nanopay_balance	Consulta el Saldo Disponible Real (depósitos del gateway menos firmas pendientes).
submit_intent	Ejecuta un pago USDC estándar con aplicación de cumplimiento y políticas.
get_intent	Recupera el estado y los metadatos de cumplimiento de una intención de pago previamente enviada.
list_intents	Obtén intenciones de pago recientes para revisión del rastro de auditoría.
open_channel	Bloquea fondos en un contrato inteligente para microtransacciones de alta frecuencia.
consume_channel	Ejecuta micropagos instantáneos sin gas dentro de un canal abierto.
settle_channel	Cierra el vault y distribuye los fondos en cadena.
get_channel	Consulta la capacidad actual y el estado de un canal de pago específico.
list_channels	Lista todos los canales de pago asociados con la billetera del agente.
get_balance	Recupera el saldo USDC actual de la Billetera de Contrato Inteligente principal del agente.
get_history	Obtén el historial de transacciones recientes del agente.
transfer	Ejecuta una transferencia USDC síncrona estándar (v1).
cross_chain_transfer	Ejecuta un pago CCTP entre cadenas a través de Squid Router (p. ej., Ethereum -> Akash).
smart_fetch	Negociación automática HTTP heredada para paywalls basados en HTTP.

Prompts

Nombre del Prompt	Descripción
nanopay_usage_instruction	Mejores prácticas para financiar el gateway y ejecutar operaciones nanopay.
create_intent_payment_instruction	Reglas para estructurar pagos conformes, agregar memos y manejar rechazos por políticas.
setup_microtransactions_instruction	Guía paso a paso para abrir, consumir y liquidar canales de vault.
create_payment_instruction	Reglas estándar para transferencias heredadas basadas en idempotencia.

Recursos

URI del Recurso	Descripción
modexia://docs/llms_context	La Guía Completa del Protocolo de Desarrollador de Modexia con reglas económicas generales para enjambres.

---

Configuración y Preparación

Este servidor requiere una Clave de API de Modexia para funcionar. Puedes obtener una creando una cuenta de desarrollador en modexia.software.

Variable	Descripción
MODEXIA_API_KEY	Requerida. Tu clave de desarrollador de Modexia (p. ej. mx_test_...)
MODEXIA_BASE_URL	Opcional. Sobrescribe el endpoint de la API. Por defecto usa el Entorno de Pruebas (Sandbox).

Cómo usar uvx (Recomendado)

Puedes ejecutar este servidor directamente en cualquier cliente MCP que admita comandos ejecutables estándar:

uvx modexia-mcp

Claude Desktop

Para usar Modexia con Claude Desktop, agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "modexia": {
      "command": "uvx",
      "args": ["modexia-mcp"],
      "env": {
        "MODEXIA_API_KEY": "mx_test_YourApiKeyHere"
      }
    }
  }
}

---

Contribuir al Código Abierto

Aceptamos activamente contribuciones de la comunidad para mejorar este servidor MCP. Debido a que actúa como la interfaz principal para agentes de IA autónomos, priorizamos fuertemente la estabilidad y una ingeniería de prompts estricta.

1. Clona el Repositorio: git clone https://github.com/Modexia/modexia-mcp.git
2. Instala las Dependencias: pip install -e .
3. Ejecuta Localmente: Puedes ejecutar el servidor en modo stdio para pruebas locales mediante python -m modexia_mcp
4. Envía PRs: Abre una Solicitud de Extracción (Pull Request) dirigida a la rama main.

---

Modelo de Seguridad

El Servidor MCP de Modexia nunca expone tus claves privadas al contexto del LLM. La IA solo tiene permiso para activar herramientas MCP explícitamente configuradas. Los límites de política (p. ej., gasto diario máximo, topes por hora) se aplican automáticamente en el backend de Modexia. Incluso una IA alucinando no puede vaciar tu billetera más allá de tus salvaguardas predefinidas.

Licencia y Soporte

modexia-mcp es una herramienta de código abierto regida por la Licencia MIT.

¿Necesitas ayuda para escalar tu enjambre de agentes o configurar tus claves de API? Accede a tu panel de desarrollador y explora la documentación en modexia.software.