Skip to main content
P

PayPal

@codespar/mcp-paypal · v0.1.2

🌐 GlobalPagamentosAuth · OAuth2beta19 ferramentas3 variáveis de ambiente

Gigante global de pagamentos + payouts. Dono do Braintree (pacote separado). Orders v2 + Payments + Payouts + Subscriptions + Disputes + Webhooks. OAuth2 client_credentials. Toggle sandbox/live.

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • Chamadas hospedadas com chave de teste não estão disponíveis: o runtime não registrou o comportamento deste provedor em teste (test venue unclassified).
Pacote
@codespar/mcp-paypal
Versão
0.1.2
dist-tag npm
latest
Categoria
Pagamentos
Auth
OAuth2
País
🌐 Global
Licença
MIT
Transporte
stdio · streamable-http

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente3 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 19 ferramentas. Comece por create_order.
terminal
# Claude Code claude mcp add paypal -e PAYPAL_CLIENT_ID=… -e PAYPAL_CLIENT_SECRET=… -e PAYPAL_ENV=… -- npx -y @codespar/mcp-paypal@0.1.2 # then: /mcp to confirm the server is connected
Variáveis de ambiente3 variáveis
PAYPAL_CLIENT_IDPayPal REST app client id (from developer.paypal.com Apps & Credentials).obrigatória
PAYPAL_CLIENT_SECRETPayPal REST app client secret (OAuth2 client_credentials password).obrigatóriasegredo
PAYPAL_ENVPayPal environment. 'sandbox' (default, https://api-m.sandbox.paypal.com) or 'live' (https://api-m.paypal.com).opcional

Nomes lidos do código do pacote (@codespar/mcp-paypal@0.1.2). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada democreate_order

"Create a PayPal Order via POST /v2/checkout/orders. Pass intent"

tools/callcreate_orderresultado devolvido

Ferramentas

O que o seu agente pode chamar.

19 ferramentas, como o tools/list do pacote as devolve.

create_order

Create a PayPal Order via POST /v2/checkout/orders. Pass intent ('CAPTURE' or 'AUTHORIZE') and purchase_units (each with an amount object). Returns the order with id, status, and HATEOAS links (including the approve URL for the buyer).

get_order

Fetch a PayPal Order by id via GET /v2/checkout/orders/{id}. Returns the full order including status, purchase_units, and payments collection.

capture_order

Capture payment for an approved order via POST /v2/checkout/orders/{id}/capture. Use after the buyer approves an order with intent=CAPTURE. Returns the captured payment details.

authorize_order

Authorize payment for an approved order via POST /v2/checkout/orders/{id}/authorize. Use after the buyer approves an order with intent=AUTHORIZE. Returns the created authorization (capture later with capture_authorization).

capture_authorization

Capture a previously authorized payment via POST /v2/payments/authorizations/{id}/capture. Pass an amount object for partial captures, or omit to capture the full authorized amount. Set final_capture=true on the last partial capture.

refund_capture

Refund a captured payment via POST /v2/payments/captures/{id}/refund. Pass an amount object for partial refunds, or omit for a full refund. Idempotent via PayPal-Request-Id.

void_authorization

Void (release) an unsettled authorization via POST /v2/payments/authorizations/{id}/void. Use when funds were authorized but will not be captured. Returns 204 No Content on success.

get_payment_details

Fetch a payment object by id via GET /v2/payments/{type}/{id}. type is one of 'authorizations', 'captures', or 'refunds'. Returns the full payment object with status and links.

create_batch_payout

Create a batch payout via POST /v1/payments/payouts. sender_batch_header carries metadata; items is an array of payout_item objects each with recipient_type, amount { currency, value }, receiver, and note. Async — poll get_payout to track status.

get_payout

Fetch a payout batch by id via GET /v1/payments/payouts/{batch_id}. Returns batch_header (status, time_created, etc.) and items array with per-item status.

get_payout_item

Fetch a single payout item by id via GET /v1/payments/payouts-item/{item_id}. Use to inspect the status of one recipient inside a batch (UNCLAIMED, SUCCESS, FAILED, etc).

create_subscription

Create a billing subscription via POST /v1/billing/subscriptions. plan_id is the id of a previously created billing plan. Returns the subscription with status (APPROVAL_PENDING) and HATEOAS approve link for the buyer.

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-paypal@0.1.2). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O codespar_discover lista as ferramentas deste servidor, mas um projeto com chave de teste ainda não consegue chamá-las: o runtime não registrou o que este provedor faz em modo de teste e recusa em vez de adivinhar.

Protocolo

Qualquer cliente MCP

stdio · streamable-http

Perguntas

Antes de instalar.

Como instalo o servidor MCP PayPal?

Rode npx -y @codespar/mcp-paypal@0.1.2 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com PayPal?

PayPal expõe 19 ferramentas de pagamentos. Seu agente as chama diretamente; a lista completa está acima.

Como PayPal autentica, e como as credenciais são guardadas?

PayPal usa OAuth2. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como PayPal lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.1.2, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

PayPal é open source? Como reporto um bug?

Sim. PayPal tem licença MIT e está publicado no npm como @codespar/mcp-paypal, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
PayPal — MCP server · 19 tools | CodeSpar