O que é PayPal MCP Server?
O PayPal hospeda seu servidor em https://mcp.paypal.com, com um sandbox em https://mcp.sandbox.paypal.com. A entrada do PayPal no registro oficial do MCP lista os caminhos /mcp (Streamable HTTP) e /sse; a documentação para desenvolvedores, atualizada pela última vez em 30 de junho de 2026, ainda mostra /http e /sse, usados por meio do mcp-remote com um login no PayPal ou um token bearer gerado a partir do client ID e do secret do seu app.
Uma versão local roda com npx -y @paypal/mcp --tools=all (Node 18+), um PAYPAL_ACCESS_TOKEN e PAYPAL_ENVIRONMENT definido como SANDBOX ou PRODUCTION. Sua última versão no npm foi a 1.8.1, em 28 de outubro de 2025, e o repositório no GitHub não teve commits desde então.
As 30 ferramentas cobrem faturas (criar, enviar, lembrar, cancelar, QR codes), pedidos, pagamento e reembolsos, disputas, rastreamento de envios, produtos de catálogo, planos de assinatura e assinaturas, e listagem de transações.
Como instalar PayPal MCP Server
https://mcp.paypal.com/mcpPayPal MCP Server vale a pena?
No papel, o servidor faz o que os lojistas do PayPal querem delegar: rascunhar e enviar faturas, cobrar as não pagas, consultar pedidos, emitir reembolsos e analisar disputas. O endpoint de sandbox é bem-vindo e permite testar prompts antes de mexer com dinheiro real.
Na prática, o projeto parece abandonado. O pacote de código aberto não muda desde a versão 1.8.1, de outubro de 2025, o repositório tem 13 estrelas, e uma issue aberta em julho de 2026 relata que o endpoint de autorização OAuth do servidor hospedado devolve HTTP 500 para todas as requisições, em produção e no sandbox. Outra issue aberta diz que create_invoice rejeita argumentos montados a partir do seu próprio schema publicado. O registro e a documentação divergem sobre o caminho do endpoint, e em 26 de outubro uma requisição simples ao caminho documentado /http devolveu 404, enquanto /mcp respondeu com um desafio de autenticação, então o caminho do registro é o que deve ser configurado.
O caminho local ainda funciona com um token, com atrito. Os tokens de acesso de produção duram oito horas, então alguém precisa regenerar o PAYPAL_ACCESS_TOKEN a partir do client ID e do secret, e o token carrega as permissões que o app REST tiver. Não há modo somente leitura nem filtro de ferramentas além da flag --tools.
Os controles de segurança são escassos para um servidor que movimenta dinheiro. Não há etapa de aprovação humana: create_refund, pay_order e accept_dispute_claim agem imediatamente, e aceitar uma disputa significa ceder nela. Ative a aprovação por ferramenta no seu cliente. Para um servidor que pode ceder uma disputa, e sua tarifa de $15, em uma única chamada, essa lacuna importa mais do que o número de ferramentas.
Onde ele se destaca
Uma empresa de paisagismo de duas pessoas que fatura pelo PayPal
Criar e enviar faturas por um chat em vez do painel do PayPal
Peça ao agente para rascunhar uma fatura para um cliente e um valor específicos, revise e depois envie. O servidor é gratuito; cada fatura paga custa os 3.49% padrão mais uma taxa fixa para pagamentos pelo checkout do PayPal, ou 2.99% mais uma taxa fixa para cartões.
Um desenvolvedor em uma pequena loja de e-commerce
Prototipar no sandbox um agente que concilia pedidos e reembolsos
Rode npx @paypal/mcp contra o SANDBOX com um token de curta duração e teste list_transactions, get_order e create_refund. Planeje uma renovaç ão de token a cada poucas horas e aprovação por chamada antes de passar para produção.
Um gerente de operações em uma empresa de caixas por assinatura
Analisar as disputas abertas toda manhã
list_disputes e get_dispute dão um resumo para triagem; mantenha accept_dispute_claim sob aprovação manual, já que aceitar significa ceder no caso. Nos EUA, as tarifas de disputa são de $15 cada no preço padrão.
Antes de decidir
- Configuração
- Hospedado: aponte o mcp-remote para o endpoint de sandbox ou de produção e faça login no PayPal pelo navegador, ou passe um token bearer. Local: npx -y @paypal/mcp --tools=all com um token de acesso do Developer Dashboard. Documentado para Claude Desktop, Cursor, Cline e GitHub Copilot.
- Integrações
- 30 ferramentas: sete para faturas, cinco para pedidos, pagamento e reembolsos, três para disputas, duas para rastreamento de envios, quatro para produtos de catálogo, oito para assinaturas e planos, e list_transactions. A maioria das ferramentas de escrita age imediatamente.
- Dados e privacidade
- O servidor pode fazer tudo o que o app REST do PayPal ou a conta logada podem, incluindo reembolsos e pagamentos. O servidor hospedado vê todas as requisições; o PayPal não publica termos de retenção específicos para o MCP e o repositório não tem política de segurança, algo que uma issue aberta pede.
- Custo em escala
- Sem taxa pelo servidor. As tarifas padrão do PayPal se aplicam ao que ele cria: faturamento nos EUA a 3.49% mais uma taxa fixa pelo checkout do PayPal, 2.99% para cartões e $15 por disputa. O PayPal não publica limites de taxa da API e limita com HTTP 429 o tráfego que considera abusivo.
- Limites
- Sem relatórios além de list_transactions, sem ferramentas de repasses ou saldo, OAuth hospedado relatado com falhas e tokens de produção que expiram após oito horas.
O que é bom
- Endpoint de sandbox para testes seguros
- 30 ferramentas para faturas, reembolsos, disputas e assinaturas
- Opções hospedada e local
O que não é
- Sem versão no npm nem commit desde outubro de 2025
- OAuth hospedado relatado como quebrado desde julho de 2026
- Sem etapa de aprovação para reembolsos, pagamentos ou aceitação de disputas
- Os tokens locais expiram após oito horas
Ideal para
Lojistas do PayPal que querem um assistente para gerenciar faturas e consultar transações.
Alternativas ao PayPal MCP Server
PayPal MCP Server: perguntas frequentes
- PayPal MCP Server vale a pena?
- O servidor do próprio PayPal cobre as tarefas certas do lojista, mas o pacote local está congelado há um ano e uma issue aberta desde julho relata falha no login do servidor hospedado. Damos nota 3.4 de 5.
- Quanto custa PayPal MCP Server?
- Conexão gratuita; aplicam-se as tarifas normais do PayPal.
- Quais são as desvantagens de PayPal MCP Server?
- Sem versão no npm nem commit desde outubro de 2025; oAuth hospedado relatado como quebrado desde julho de 2026; sem etapa de aprovação para reembolsos, pagamentos ou aceitação de disputas; os tokens locais expiram após oito horas.
- Para quem PayPal MCP Server é indicado?
- Lojistas do PayPal que querem um assistente para gerenciar faturas e consultar transações.
- Quanto custa PayPal MCP Server para uma equipe ou em produção?
- Sem taxa pelo servidor. As tarifas padrão do PayPal se aplicam ao que ele cria: faturamento nos EUA a 3.49% mais uma taxa fixa pelo checkout do PayPal, 2.99% para cartões e $15 por disputa. O PayPal não publica limites de taxa da API e limita com HTTP 429 o tráfego que considera abusivo.
- PayPal MCP Server é seguro para dados da empresa?
- O servidor pode fazer tudo o que o app REST do PayPal ou a conta logada podem, incluindo reembolsos e pagamentos. O servidor hospedado vê todas as requisições; o PayPal não publica termos de retenção específicos para o MCP e o repositório não tem política de segurança, algo que uma issue aberta pede.
- Quais são as melhores alternativas ao PayPal MCP Server?
- As alternativas mais próximas que analisamos são Stripe MCP e Square MCP Server.
Respostas verificadas em 26 de out. de 2026.