NOWPayments MCP

NOWPayments MCP server

Sobre

O NOWPayments MCP Server é um wrapper leve em torno da API NOWPayments que permite interação perfeita com pagamentos em criptomoedas por meio de interfaces baseadas em LLM, como chatbots e agentes de IA.

Ele abstrai a integração direta com a API, permitindo que você crie pagamentos, gere faturas e acompanhe transações usando chamadas de ferramentas simples.

Link:

http://mcp.nowpayments.io/mcp

Principais Recursos

• Suporte a uma ampla variedade de criptomoedas
• Criação de faturas hospedadas e pagamentos diretos
• Acompanhamento de status de pagamento em tempo real
• Cálculo do valor mínimo para pares de moedas
• Autenticação simples baseada em chave de API

Casos de Uso

• Pagamentos em cripto em agentes de IA e interfaces de chat
• Fluxos automatizados de cobrança e pagamento
• Checkout de e-commerce com suporte a cripto
• Integrações de pagamento sem código / com pouco código

Recursos

• Recuperar uma lista completa de criptomoedas suportadas
• Calcular valores mínimos de pagamento para pares de moedas
• Criar faturas de pagamento hospedadas
• Criar pagamentos diretos em cripto
• Acompanhar o status do pagamento em tempo real

Autenticação

Todos os métodos exigem uma chave de API NOWPayments.

A chave de API é usada internamente pelo servidor MCP para autenticar solicitações à API NOWPayments.

Métodos

get_full_currencies

Obter a lista de criptomoedas suportadas pela NOWPayments, incluindo metadados detalhados para cada moeda.

Casos de uso:

• Exibir opções de pagamento disponíveis
• Validar moedas suportadas antes de criar pagamentos

get_min_amount

Obter o valor mínimo de pagamento exigido para um par específico de moeda de entrada / moeda de saída, incluindo ambas as opções:

• Opção de taxa fixa
• Opção padrão (taxa flutuante)

Casos de uso:

• Validar valores de pagamento antes de criar uma transação
• Mostrar limites mínimos aos usuários

create_invoice

Criar uma fatura hospedada e retornar uma URL de pagamento.

O pagador é redirecionado para uma página de pagamento hospedada pela NOWPayments para concluir a transação.

Casos de uso:

• Fluxos de checkout de e-commerce

create_payment

Criar um pagamento direto com parâmetros predefinidos.

Retorna todos os detalhes necessários para o pagador enviar os fundos manualmente (por exemplo, endereço da carteira, valor).

Casos de uso:

• Fluxos de pagamento personalizados
• Transações controladas por backend
• Integrações avançadas

get_payment_status

Recuperar o status atual e os detalhes de um pagamento usando seu payment_id.

Casos de uso:

• Monitorar o ciclo de vida do pagamento
• Atualizar o status do pedido
• Lidar com confirmações e falhas

Como Funciona

O servidor MCP atua como uma ponte entre interfaces baseadas em LLM e a API NOWPayments.

Em vez de escrever integrações de API manualmente, você pode:

• Pedir a um chatbot para criar um pagamento
• Gerar faturas dinamicamente
• Verificar status de transações em tempo real

Todas as solicitações são tratadas com segurança usando sua chave de API NOWPayments.

Exemplos de Casos de Uso

• Processamento de pagamentos em cripto em agentes de IA
• Fluxos de cobrança automatizados
• Experiências de checkout baseadas em chat
• Ferramentas internas para equipes financeiras
• Integrações SaaS compatíveis com Web3

Como Começar

1. Obtenha sua chave de API

Cadastre-se na NOWPayments e gere sua chave de API no painel.

2. Configure o Servidor MCP

Forneça sua chave de API na configuração do servidor MCP:

3. Conecte-se ao seu cliente MCP

Adicione o servidor NOWPayments MCP ao seu cliente compatível com MCP (por exemplo, ChatGPT, Claude ou outros frameworks de agentes).

4. Comece a usar

Depois de conectado, você pode chamar métodos diretamente por meio do seu LLM:

Exemplos:

• "Obter criptomoedas disponíveis" → get_full_currencies
• "Criar uma fatura de US$ 50 em BTC" → create_invoice
• "Verificar status do pagamento" → get_payment_status

FAQ

O que é o NOWPayments MCP Server?

Esta ferramenta é um servidor MCP para interagir com a API NOWPayments, permitindo a criação programática de pagamentos em cripto, faturas e acompanhamento de pagamentos por meio de interfaces baseadas em LLM.

Quais recursos principais ele oferece?

Ele fornece recursos essenciais para fluxos de trabalho de pagamento em cripto, incluindo:

• Recuperar criptomoedas suportadas
• Calcular valores mínimos de pagamento
• Criar faturas hospedadas e pagamentos diretos
• Acompanhar o status do pagamento em tempo real

Posso criar faturas e pagamentos usando esta ferramenta?

Sim, o servidor inclui métodos dedicados para faturas hospedadas (create_invoice) e pagamentos diretos (create_payment), permitindo integração flexível dependendo do seu caso de uso.

O que preciso para começar?

Você precisa de uma conta ativa na NOWPayments e uma chave de API.
A chave de API deve ser configurada (por exemplo, como NOWPAYMENTS_API_KEY) e é usada para autenticar todas as solicitações.

Como os valores de pagamento são tratados?

Os valores de pagamento dependem da criptomoeda selecionada e do par de moedas.
Você pode usar o método get_min_amount para recuperar o valor mínimo exigido para transações de taxa fixa e taxa flutuante antes de criar um pagamento.

Qual é a diferença entre pagamentos de taxa fixa e padrão (taxa flutuante)?

• Pagamentos de taxa fixa bloqueiam a taxa de câmbio por um tempo limitado (10 minutos), garantindo que o pagador envie um valor exato e o destinatário receba um pagamento previsível. Isso é útil para estabilidade de preços e para evitar volatilidade.
• Pagamentos padrão (taxa flutuante) usam a taxa de mercado atual no momento em que a transação é processada. O valor final recebido pode variar dependendo das flutuações do mercado.

Você pode usar o método get_min_amount para comparar valores mínimos para ambas as opções antes de escolher o fluxo preferido.