NOWPayments MCP

Servidor NOWPayments MCP

Acerca de

El Servidor NOWPayments MCP es un envoltorio ligero alrededor de la API de NOWPayments que permite una interacción fluida con pagos en criptomonedas a través de interfaces impulsadas por LLM, como chatbots y agentes de IA.

Abstrae la integración directa con la API, permitiéndote crear pagos, generar facturas y rastrear transacciones mediante llamadas a herramientas simples.

Enlace:

http://mcp.nowpayments.io/mcp

Características clave

• Soporte para una amplia gama de criptomonedas
• Creación de facturas alojadas y pagos directos
• Seguimiento del estado de pago en tiempo real
• Cálculo del monto mínimo para pares de divisas
• Autenticación simple basada en clave de API

Casos de uso

• Pagos con criptomonedas en agentes de IA e interfaces de chat
• Facturación automatizada y flujos de pago
• Pago en comercio electrónico con soporte de criptomonedas
• Integraciones de pago sin código / con código mínimo

Características

• Obtener una lista completa de criptomonedas compatibles
• Calcular montos mínimos de pago para pares de divisas
• Crear facturas de pago alojadas
• Crear pagos directos con criptomonedas
• Rastrear el estado del pago en tiempo real

Autenticación

Todos los métodos requieren una clave de API de NOWPayments.

La clave de API es utilizada internamente por el servidor MCP para autenticar solicitudes a la API de NOWPayments.

Métodos

get_full_currencies

Obtener la lista de criptomonedas compatibles con NOWPayments, incluidos metadatos detallados para cada divisa.

Casos de uso:

• Mostrar opciones de pago disponibles
• Validar divisas compatibles antes de crear pagos

get_min_amount

Obtener el monto mínimo de pago requerido para un par de divisas de entrada / salida específico, incluyendo ambas opciones:

• Opción de tasa fija
• Opción estándar (tasa flotante)

Casos de uso:

• Validar montos de pago antes de crear una transacción
• Mostrar umbrales mínimos a los usuarios

create_invoice

Crear una factura alojada y devolver una URL de pago.

El pagador es redirigido a una página de pago alojada por NOWPayments para completar la transacción.

Casos de uso:

• Flujos de pago en comercio electrónico

create_payment

Crear un pago directo con parámetros predefinidos.

Devuelve todos los detalles necesarios para que el pagador envíe fondos manualmente (por ejemplo, dirección de billetera, monto).

Casos de uso:

• Flujos de pago personalizados
• Transacciones controladas por el backend
• Integraciones avanzadas

get_payment_status

Recuperar el estado actual y los detalles de un pago utilizando su payment_id.

Casos de uso:

• Monitorear el ciclo de vida del pago
• Actualizar el estado del pedido
• Gestionar confirmaciones y fallos

Cómo funciona

El servidor MCP actúa como un puente entre interfaces basadas en LLM y la API de NOWPayments.

En lugar de escribir integraciones de API manualmente, puedes:

• Pedirle a un chatbot que cree un pago
• Generar facturas dinámicamente
• Consultar estados de transacciones en tiempo real

Todas las solicitudes se gestionan de forma segura utilizando tu clave de API de NOWPayments.

Ejemplos de casos de uso

• Procesamiento de pagos con criptomonedas en agentes de IA
• Flujos de facturación automatizados
• Experiencias de pago basadas en chat
• Herramientas internas para equipos de finanzas
• Integraciones SaaS compatibles con Web3

Cómo empezar

1. Obtén tu clave de API

Regístrate en NOWPayments y genera tu clave de API desde el panel de control.

2. Configura el servidor MCP

Proporciona tu clave de API en la configuración del servidor MCP:

3. Conéctate a tu cliente MCP

Añade el servidor NOWPayments MCP a tu cliente compatible con MCP (por ejemplo, ChatGPT, Claude u otros marcos de agentes).

4. Empieza a usarlo

Una vez conectado, puedes llamar a los métodos directamente a través de tu LLM:

Ejemplos:

• "Obtener criptomonedas disponibles" → get_full_currencies
• "Crear una factura BTC de $50" → create_invoice
• "Consultar estado del pago" → get_payment_status

Preguntas frecuentes

¿Qué es el servidor NOWPayments MCP?

Esta herramienta es un servidor MCP para interactuar con la API de NOWPayments, que permite la creación programática de pagos con criptomonedas, facturas y seguimiento de pagos a través de interfaces impulsadas por LLM.

¿Qué características clave ofrece?

Proporciona funcionalidades esenciales para flujos de pago con criptomonedas, incluyendo:

• Obtener criptomonedas compatibles
• Calcular montos mínimos de pago
• Crear facturas alojadas y pagos directos
• Rastrear el estado del pago en tiempo real

¿Puedo crear facturas y pagos con esta herramienta?

Sí, el servidor incluye métodos dedicados tanto para facturas alojadas (create_invoice) como para pagos directos (create_payment), lo que permite una integración flexible según tu caso de uso.

¿Qué necesito para empezar?

Necesitas una cuenta activa de NOWPayments y una clave de API.
La clave de API debe configurarse (por ejemplo, como NOWPAYMENTS_API_KEY) y se utiliza para autenticar todas las solicitudes.

¿Cómo se gestionan los montos de pago?

Los montos de pago dependen de la criptomoneda seleccionada y del par de divisas.
Puedes usar el método get_min_amount para recuperar el monto mínimo requerido tanto para transacciones de tasa fija como de tasa flotante antes de crear un pago.

¿Cuál es la diferencia entre pagos de tasa fija y estándar (tasa flotante)?

• Pagos de tasa fija fijan el tipo de cambio por un tiempo limitado (10 minutos), asegurando que el pagador envíe un monto exacto y el receptor reciba un pago predecible. Esto es útil para la estabilidad de precios y para evitar la volatilidad.
• Pagos estándar (tasa flotante) utilizan la tasa de mercado actual en el momento en que se procesa la transacción. El monto final recibido puede variar según las fluctuaciones del mercado.

Puedes usar el método get_min_amount para comparar los montos mínimos de ambas opciones antes de elegir el flujo preferido.