Skip to content
Agentmart
Submit a tool

MCP PayPal

MCP server for PayPal — global payments + payouts: Orders v2, Payments, Subscriptions, Disputes

Connector by codespar · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 274
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/codespar-mcp-paypal

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

MCP server for PayPal — global payments + payouts: Orders v2, Payments, Subscriptions, Disputes

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
11 read · 7 write · 0 delete · 1 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 19

Read from the source code; the running server may list different tools.

Read 11 · Look things up without changing anything.

  • capture_authorization
  • capture_order
  • get_dispute
  • get_order
  • get_payment_details
  • get_payout
  • get_payout_item
  • get_subscription
  • list_disputes
  • list_webhooks
  • verify_webhook_signature

Write 7 · Create, change, send or run things.

  • accept_dispute_claim
  • authorize_order
  • cancel_subscription
  • create_batch_payout
  • create_order
  • create_subscription
  • refund_capture

Not yet classified 1 · We could not tell from the name and description.

  • void_authorization

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • PAYPAL_CLIENT_SECRET

Other settings (environment variables or headers).

  • PAYPAL_CLIENT_ID
  • PAYPAL_ENV

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • accept_dispute_claim

    Accept liability for a dispute claim via POST /v1/customer/disputes/{id}/accept-claim. The disputed amount is refunded to the buyer. Terminal action.

  • 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).

  • cancel_subscription

    Cancel an active subscription via POST /v1/billing/subscriptions/{id}/cancel. Pass a reason string. Returns 204 No Content on success.

  • 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.

  • 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.

  • 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.

  • 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).

  • 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.

  • get_dispute

    Fetch a dispute by id via GET /v1/customer/disputes/{id}. Returns full dispute details including reason, status, life_cycle_stage, disputed_transactions, and messages.

  • 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.

  • 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.

  • 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).

  • get_subscription

    Fetch a subscription by id via GET /v1/billing/subscriptions/{id}. Returns id, status, plan_id, subscriber, billing_info, and links.

  • list_disputes

    List disputes via GET /v1/customer/disputes. Filter by disputed_transaction_id, dispute_state, update_time_before / update_time_after. Pagination via page_size and next_page_token.

Show 4 more tools
  • list_webhooks

    List configured webhooks for the app via GET /v1/notifications/webhooks. Returns each webhook with id, url, and event_types.

  • 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.

  • verify_webhook_signature

    Verify a webhook event signature via POST /v1/notifications/verify-webhook-signature. Pass the headers and body received on your webhook endpoint. Returns verification_status SUCCESS or FAILURE.

  • 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.

Signals

Stars
274
Forks
51
Open issues
14
Weekly downloads
14
Last commit (this folder)
Sep 27, 2026 (1 month ago)
Last release
Jun 22, 2026 (4 months ago)
Last package publish
Jun 22, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.codespar/mcp-paypal
Version
0.1.2
Auth
API key
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from codespar

Cite this page

MCP PayPal. Agent Mart. https://agentmart.dev/connectors/codespar-mcp-paypal (last updated 2026-10-25)