Install
npm install @paddle/paddle-node-sdkTry itExperimental
See what an agent can do with Paddle before you ever sign up. Pick a story: recorded sessions replay real probe-harness transcripts; commands tagged live-capable can re-run against the real endpoint from our edge, right now (▶ run live — the exact same request, live and recorded lines always labeled); the live MCP handshake runs real requests from our edge, right now — including, where the server allows it, one real read-only tool call (bring your own key for auth-gated servers); sandboxed self-drive sessions are designed and gated (docs/TRY-IT.md).
$curl -s https://developer.paddle.com/sdks/ai/paddle-mcp.md | head -6recorded session — replayed, not liveVerified integrations
No integration evidence found in our corpus for this product yet — that means none was found, never that it doesn’t integrate.
By theme — the product's score on each story themeBy theme
Agenticness — how well agents can access and operate the productAgenticnessevidence →
How well agents can access and operate the product
Automation depth — how much of the product can run unattendedAutomation depthevidence →
How much of the product can run unattended
Billing invoicing — stories about billing invoicing in this arenaBilling invoicingevidence →
Stories about billing invoicing in this arena
Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptanceevidence →
Stories about checkout acceptance in this arena
Compliance security — stories about compliance security in this arenaCompliance securityevidence →
Stories about compliance security in this arena
Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experienceevidence →
Day-to-day developer experience — setup friction, docs, debugging, iteration speed
Disputes fraud — stories about disputes fraud in this arenaDisputes fraudevidence →
Stories about disputes fraud in this arena
Global currency tax — stories about global currency tax in this arenaGlobal currency taxevidence →
Stories about global currency tax in this arena
Openness — open source, data portability, and self-hosting storiesOpennessevidence →
Open source, data portability, and self-hosting stories
Payouts reconciliation — stories about payouts reconciliation in this arenaPayouts reconciliationevidence →
Stories about payouts reconciliation in this arena
Platform marketplace — stories about platform marketplace in this arenaPlatform marketplaceevidence →
Stories about platform marketplace in this arena
Privacy posture — data-handling and privacy storiesPrivacy postureevidence →
Data-handling and privacy stories
Story verdicts — every judged story with its evidenceStory verdicts
Follow the green: where the map greys out is where Paddle stops today. ✓ full · ~ partial · ! disputed · — none · n/a not applicable.
Agenticness — how well agents can access and operate the productAgenticness
How well agents can access and operate the product
API surface
Drive the product through a documented public API
✓9/10
unlocks → Versioning policy · Official CLI · Full data export
Subscribe to events via webhooks
✓8/10
Build against official SDKs
✓9/10
Issue scoped/least-privilege API credentials for an agent
~6/10
unlocks → Autonomous automations
Connect an agent via an official MCP server
✓9/10
Download a machine-readable API spec (OpenAPI or equivalent)
✓8/10
Rely on versioned APIs with a documented deprecation policy
—–
Test against a sandbox environment without touching production data
✓9/10
Explore an interactive API reference with runnable examples
~6/10
Docs for agents
Point an agent at llms.txt or agent-oriented docs
✓9/10
Agentic features
Delegate tasks to a built-in AI assistant inside the product
~6/10
Operate the product with natural-language commands
✓9/10
unlocks → Autonomous automations
Plug MCP servers into this product so it can use their tools
n/an/a
Get AI-generated insights and suggestions from my data inside the product
~4/10
Set up automations that run autonomously in the background
—–
Automation depth — how much of the product can run unattendedAutomation depth
How much of the product can run unattended
Billing invoicing — stories about billing invoicing in this arenaBilling invoicing
Stories about billing invoicing in this arena
Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance
Stories about checkout acceptance in this arena
Accept an online card payment within a day of signing up
~6/10
Checkout surfaces
Create a shareable payment link from the dashboard with no code and start selling immediately
—0/10
Offer digital wallets and local payment methods (Apple Pay, Google Pay, bank redirects, BNPL) from the same integration
~3/10
Compliance security — stories about compliance security in this arenaCompliance security
Stories about compliance security in this arena
Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experience
Day-to-day developer experience — setup friction, docs, debugging, iteration speed
Disputes fraud — stories about disputes fraud in this arenaDisputes fraud
Stories about disputes fraud in this arena
Have an agent handle a dispute end-to-end, retrieving it, assembling evidence, and submitting the response via the API
—0/10
Respond to a chargeback with structured evidence and track the dispute lifecycle to resolution
—0/10
Screen transactions with machine-learning fraud scores and write custom block, review, and allow rules
—0/10
Issue full or partial refunds from both the dashboard and the API
~4/10
Global currency tax — stories about global currency tax in this arenaGlobal currency tax
Stories about global currency tax in this arena
Openness — open source, data portability, and self-hosting storiesOpenness
Open source, data portability, and self-hosting stories
Payouts reconciliation — stories about payouts reconciliation in this arenaPayouts reconciliation
Stories about payouts reconciliation in this arena
Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying charges
✓7/10
Control the payout schedule and see exactly which charges, fees, and refunds make up each payout
~6/10
Reconcile settlements to bank deposits with itemized reports covering fees, refunds, and chargebacks
✓8/10
Platform marketplace — stories about platform marketplace in this arenaPlatform marketplace
Stories about platform marketplace in this arena
Privacy posture — data-handling and privacy storiesPrivacy posture
Data-handling and privacy stories
Sorted by importance (agentic first) (high → low) · 54/54 stories · click a row’s chevron for the rationale and evidence
Connect an agent via an official MCP server G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | full | 9/10 | Tprobed | |
Drive the product through a documented public API G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | full | 9/10 | Tprobed | |
Delegate tasks to a built-in AI assistant inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | partial | 6/10 | Cclaimed | |
Plug MCP servers into this product so it can use their tools G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | n/a | untested | none yet | |
Build against official SDKs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 9/10 | Tprobed | |
Operate the product with natural-language commands G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 9/10 | Cclaimed | |
Point an agent at llms.txt or agent-oriented docs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 9/10 | Tprobed | |
Download a machine-readable API spec (OpenAPI or equivalent) G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 8/10 | Tprobed | |
Subscribe to events via webhooks G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 8/10 | Cclaimed | |
Explore an interactive API reference with runnable examples G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 6/10 | Tprobed | |
Issue scoped/least-privilege API credentials for an agent G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 6/10 | Cclaimed | |
Run the product headlessly / in CI for automation G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 6/10 | Tprobed | |
Get AI-generated insights and suggestions from my data inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 4/10 | Cclaimed | |
Use an official CLI G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Rely on versioned APIs with a documented deprecation policy G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | untested | none yet | |
Set up automations that run autonomously in the background G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | untested | none yet | |
Test against a sandbox environment without touching production data G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 1 | full | 9/10 | Cclaimed | |
Redirect customers to a vendor-hosted, conversion-optimized checkout page without building my own payment UI C Checkout surfaces | developer | Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance | 3 | full | 9/10 | Cclaimed | |
Embed customizable payment components directly in my own site or app instead of redirecting to a hosted page C Checkout surfaces | developer | Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance | 3 | full | 8/10 | Cclaimed | |
Have an agent provision a new product, price, and payment link via the API in a single session G Ai billing ops | ai-native user | Billing invoicing — stories about billing invoicing in this arenaBilling invoicing | 3 | full | 8/10 | Cclaimed | |
Reconcile settlements to bank deposits with itemized reports covering fees, refunds, and chargebacks C Reconciliation | finance-ops user | Payouts reconciliation — stories about payouts reconciliation in this arenaPayouts reconciliation | 3 | full | 8/10 | Cclaimed | |
Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying charges C Ai reconciliation | ai-native user | Payouts reconciliation — stories about payouts reconciliation in this arenaPayouts reconciliation | 3 | full | 7/10 | Cclaimed | |
Set up recurring subscription billing with plans, trials, upgrades, and proration G Subscriptions | developer | Billing invoicing — stories about billing invoicing in this arenaBilling invoicing | 3 | full | 7/10 | Cclaimed | |
Accept an online card payment within a day of signing up C Card acceptance | founder | Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance | 3 | partial | 6/10 | Cclaimed | |
Build and test the entire payment flow in a sandbox or test mode that mirrors production, with test cards for every scenario including declines and disputes C Sandbox fidelity | developer | Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experience | 3 | partial | 6/10 | Cclaimed | |
Calculate and collect the correct sales tax, VAT, or GST on every transaction automatically C Tax | finance-ops user | Global currency tax — stories about global currency tax in this arenaGlobal currency tax | 3 | disputed | 6/10 | Dcontradicted | |
Have an agent monitor failed payments via API and webhooks and drive retries and dunning outreach G Ai billing ops | ai-native user | Billing invoicing — stories about billing invoicing in this arenaBilling invoicing | 3 | partial | 6/10 | Cclaimed | |
Rely on signed webhook deliveries with automatic retries, event logs, and replay to keep my system consistent with payment state G Integration reliability | developer | Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experience | 3 | partial | 6/10 | Cclaimed | |
Define rules that trigger actions automatically on events G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 3 | partial | 4/10 | Cclaimed | |
Issue full or partial refunds from both the dashboard and the API C Refunds | finance-ops user | Disputes fraud — stories about disputes fraud in this arenaDisputes fraud | 3 | partial | 4/10 | Cclaimed | |
Export all of my data in open formats and leave G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | none | 0/10 | ||
Have an agent handle a dispute end-to-end, retrieving it, assembling evidence, and submitting the response via the API C Ai disputes | ai-native user | Disputes fraud — stories about disputes fraud in this arenaDisputes fraud | 3 | none | 0/10 | ||
Respond to a chargeback with structured evidence and track the dispute lifecycle to resolution C Disputes | finance-ops user | Disputes fraud — stories about disputes fraud in this arenaDisputes fraud | 3 | none | 0/10 | ||
Screen transactions with machine-learning fraud scores and write custom block, review, and allow rules C Fraud prevention | finance-ops user | Disputes fraud — stories about disputes fraud in this arenaDisputes fraud | 3 | none | 0/10 | ||
Prevent my data from being used to train AI models G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 3 | none | untested | none yet | |
Self-host the core product G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | n/a | untested | none yet | |
Automatically retry failed subscription payments with smart dunning and recovery emails C Subscriptions | finance-ops user | Billing invoicing — stories about billing invoicing in this arenaBilling invoicing | 2 | full | 8/10 | Cclaimed | |
Charge customers in their local currencies and settle to my bank in mine with transparent FX handling C Multi currency | founder | Global currency tax — stories about global currency tax in this arenaGlobal currency tax | 2 | full | 8/10 | Cclaimed | |
Integrate a working payment flow from the docs alone in under a day, with copy-paste examples in my language C Onboarding dx | developer | Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experience | 2 | full | 8/10 | Cclaimed | |
Control the payout schedule and see exactly which charges, fees, and refunds make up each payout C Payouts | finance-ops user | Payouts reconciliation — stories about payouts reconciliation in this arenaPayouts reconciliation | 2 | partial | 6/10 | Cclaimed | |
Do everything through the API that I can do in the UI G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | partial | 6/10 | Cclaimed | |
Keep my systems out of most of PCI DSS scope because card data is tokenized and never touches my servers C Pci compliance | developer | Compliance security — stories about compliance security in this arenaCompliance security | 2 | partial | 6/10 | Cclaimed | |
Send hosted invoices with online payment and automatic reminders C Invoicing | finance-ops user | Billing invoicing — stories about billing invoicing in this arenaBilling invoicing | 2 | partial | 6/10 | Cclaimed | |
Perform bulk operations across many items at once G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | partial | 5/10 | Cclaimed | |
Offer digital wallets and local payment methods (Apple Pay, Google Pay, bank redirects, BNPL) from the same integration C Payment methods | founder | Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance | 2 | partial | 3/10 | Cclaimed | |
Build a marketplace or platform that onboards sellers, splits payments between parties, and pays out to each seller C Marketplace | developer | Platform marketplace — stories about platform marketplace in this arenaPlatform marketplace | 2 | none | 0/10 | ||
Control data retention and deletion G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | none | 0/10 | ||
Create a shareable payment link from the dashboard with no code and start selling immediately C No code selling | founder | Checkout acceptance — stories about checkout acceptance in this arenaCheckout acceptance | 2 | none | 0/10 | ||
Schedule recurring jobs or workflows G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | none | 0/10 | ||
Choose where my data is stored (region/residency) G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | none | untested | none yet | |
Opt out of telemetry and usage tracking G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | none | untested | none yet | |
Read the product's source under an open license G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | n/a | untested | none yet | |
Safely retry any API request using idempotency keys so network failures never create duplicate charges C Integration reliability | developer | Dev experience — day-to-day developer experience — setup friction, docs, debugging, iteration speedDev experience | 2 | none | untested | none yet | |
Version, review, and roll back my automations G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 1 | n/a | untested | none yet |
Opportunities — the stories that would move this product's scores, from its own judged verdictsOpportunitiestop 8 of 32 stories with headroom
What would move Paddle’s scores — derived from its own judged verdicts, biggest headroom first. Each line quotes what the judge found missing; shipping it (or evidencing it publicly) is the fix.
Disputes fraud — stories about disputes fraud in this arenaHave an agent handle a dispute end-to-end, retrieving it, assembling evidence, and submitting the response via the API
nonemoves PA Scoreimpact 30
The evidence pack contains no mention of a Disputes/Chargebacks API endpoint, no ability to retrieve dispute details, assemble evidence, or submit a response programmatically.
Disputes fraud — stories about disputes fraud in this arenaScreen transactions with machine-learning fraud scores and write custom block, review, and allow rules
nonemoves PA Scoreimpact 30
Evidence only mentions Paddle's merchant-of-record fee covering generic 'fraud protection' and 'chargeback defense' as a bundled service, with no documentation of ML-generated fraud scores or of any UI/API for finance-ops to write custom block/review/allow rules.
Openness — open source, data portability, and self-hosting storiesExport all of my data in open formats and leave
nonemoves PA Scoreimpact 30
Paddle documents reports/reconciliation exports and an OpenAPI spec for building integrations, but there is no evidence of a customer-facing 'export all my account/business data in an open format to leave' capability — no GDPR-style data export, no full account data dump, nothing enabling migration away from Paddle with your data intact.
Privacy posture — data-handling and privacy storiesPrevent my data from being used to train AI models
nonemoves PA Scoreimpact 30
The evidence pack contains no mention of Paddle's data-usage policies for AI model training, opt-out controls, or any privacy commitments specific to AI training — it covers only checkout, billing, webhooks, MCP/agent tooling, and API auth.
Disputes fraud — stories about disputes fraud in this arenaRespond to a chargeback with structured evidence and track the dispute lifecycle to resolution
nonemoves PA Scoreimpact 30
Evidence only shows chargebacks appearing as a fee line-item in payout reconciliation reports and a passing mention that Paddle's merchant-of-record fee includes 'chargeback defense,' but there is no documentation of a finance-ops workflow for submitting structured dispute evidence or tracking a chargeback's lifecycle to resolution.
Agenticness — how well agents can access and operate the productSet up automations that run autonomously in the background
nonemoves Built-in AIimpact 30
Missing: any evidence of scheduled jobs, autonomous triggers, or background automation execution initiated by the user rather than by an explicit API/webhook call.
Agenticness — how well agents can access and operate the productUse an official CLI
nonemoves agent-readyimpact 30
Paddle's evidence covers SDKs, MCP servers, agent skills, OpenAPI/Postman specs, and webhooks, but nowhere documents an official Paddle CLI tool; the mentions of 'Claude Code, Codex, and Gemini CLI' refer to third-party AI coding CLIs that Paddle plugins integrate with, not a Paddle-branded CLI.
Agenticness — how well agents can access and operate the productRely on versioned APIs with a documented deprecation policy
nonemoves API qualityimpact 30
Missing: documented API version headers/scheme, explicit deprecation/sunset policy, and migration timelines for breaking changes.
Showing the top 8 of 32 — every none/partial verdict in the story verdicts table is headroom.
Think a verdict is wrong? Every verdicts-table row has a Flag link — see the methodology.
Coverage map — which docs area, API section, or community source covers which judged storiesCoverage map12 surfaces · 35 covered stories
Where the cited evidence behind each covered verdict came from — the same citations the verdicts table shows, no extra judging.
Sdks docs24 stories
- Point an agent at llms.txt or agent-oriented docs
- Run the product headlessly / in CI for automation
- Connect an agent via an official MCP server
- Drive the product through a documented public API
- Issue scoped/least-privilege API credentials for an agent
- Build against official SDKs
- Subscribe to events via webhooks
- Get AI-generated insights and suggestions from my data inside the product
- Delegate tasks to a built-in AI assistant inside the product
- Operate the product with natural-language commands
- Explore an interactive API reference with runnable examples
- Download a machine-readable API spec (OpenAPI or equivalent)
- Test against a sandbox environment without touching production data
- Perform bulk operations across many items at once
- Have an agent monitor failed payments via API and webhooks and drive retries and dunning outreach
- Have an agent provision a new product, price, and payment link via the API in a single session
- Accept an online card payment within a day of signing up
- Redirect customers to a vendor-hosted, conversion-optimized checkout page without building my own payment UI
- Rely on signed webhook deliveries with automatic retries, event logs, and replay to keep my system consistent with payment state
- Integrate a working payment flow from the docs alone in under a day, with copy-paste examples in my language
- Build and test the entire payment flow in a sandbox or test mode that mirrors production, with test cards for every scenario including declines and disputes
- Issue full or partial refunds from both the dashboard and the API
- Do everything through the API that I can do in the UI
- Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying charges
Build docs19 stories
- Define rules that trigger actions automatically on events
- Have an agent monitor failed payments via API and webhooks and drive retries and dunning outreach
- Have an agent provision a new product, price, and payment link via the API in a single session
- Send hosted invoices with online payment and automatic reminders
- Automatically retry failed subscription payments with smart dunning and recovery emails
- Set up recurring subscription billing with plans, trials, upgrades, and proration
- Accept an online card payment within a day of signing up
- Embed customizable payment components directly in my own site or app instead of redirecting to a hosted page
- Redirect customers to a vendor-hosted, conversion-optimized checkout page without building my own payment UI
- Keep my systems out of most of PCI DSS scope because card data is tokenized and never touches my servers
- Rely on signed webhook deliveries with automatic retries, event logs, and replay to keep my system consistent with payment state
- Integrate a working payment flow from the docs alone in under a day, with copy-paste examples in my language
- Build and test the entire payment flow in a sandbox or test mode that mirrors production, with test cards for every scenario including declines and disputes
- Charge customers in their local currencies and settle to my bank in mine with transparent FX handling
- Calculate and collect the correct sales tax, VAT, or GST on every transaction automatically
- Do everything through the API that I can do in the UI
- Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying charges
- Control the payout schedule and see exactly which charges, fees, and refunds make up each payout
- Reconcile settlements to bank deposits with itemized reports covering fees, refunds, and chargebacks
developer.paddle.com7 stories
- Set up recurring subscription billing with plans, trials, upgrades, and proration
- Embed customizable payment components directly in my own site or app instead of redirecting to a hosted page
- Redirect customers to a vendor-hosted, conversion-optimized checkout page without building my own payment UI
- Keep my systems out of most of PCI DSS scope because card data is tokenized and never touches my servers
- Charge customers in their local currencies and settle to my bank in mine with transparent FX handling
- Calculate and collect the correct sales tax, VAT, or GST on every transaction automatically
- Do everything through the API that I can do in the UI
API reference6 stories
- Run the product headlessly / in CI for automation
- Drive the product through a documented public API
- Issue scoped/least-privilege API credentials for an agent
- Perform bulk operations across many items at once
- Have an agent provision a new product, price, and payment link via the API in a single session
- Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying charges
Concepts docs5 stories
- Offer digital wallets and local payment methods (Apple Pay, Google Pay, bank redirects, BNPL) from the same integration
- Keep my systems out of most of PCI DSS scope because card data is tokenized and never touches my servers
- Charge customers in their local currencies and settle to my bank in mine with transparent FX handling
- Calculate and collect the correct sales tax, VAT, or GST on every transaction automatically
- Reconcile settlements to bank deposits with itemized reports covering fees, refunds, and chargebacks
Webhooks docs5 stories
- Run the product headlessly / in CI for automation
- Subscribe to events via webhooks
- Define rules that trigger actions automatically on events
- Have an agent monitor failed payments via API and webhooks and drive retries and dunning outreach
- Rely on signed webhook deliveries with automatic retries, event logs, and replay to keep my system consistent with payment state
llms.txt4 stories
Llms docs4 stories
- Get AI-generated insights and suggestions from my data inside the product
- Accept an online card payment within a day of signing up
- Offer digital wallets and local payment methods (Apple Pay, Google Pay, bank redirects, BNPL) from the same integration
- Integrate a working payment flow from the docs alone in under a day, with copy-paste examples in my language
OpenAPI spec3 stories
Get started docs2 stories
Llm benchmark docs2 stories
Probe proofs — replayable recordings from the probe harnessProbe proofs
Replayable recordings from our probe harness — see the Prove-It protocol to submit one.
$curl -s https://developer.paddle.com/sdks/ai/paddle-mcp.md | head -6reproduced$ curl -s https://developer.paddle.com/sdks/ai/paddle-mcp.md | head -6 > For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt). # Paddle MCP server Give AI agents access to your Paddle account so they can read data and take actions across pricing, billing, and integration workflows.
$curl -s https://developer.paddle.com/llms.txt | head -4reproduced$ curl -s https://developer.paddle.com/llms.txt | head -4 # Paddle Developer Docs > Official developer documentation for Paddle Billing. Guides, API reference, and changelog for building subscriptions, checkout, payments, and webhooks.
$curl -s https://mcp.paddle.com/.well-known/oauth-protected-resourcereproduced$ curl -s https://mcp.paddle.com/.well-known/oauth-protected-resource
{"resource":"https://mcp.paddle.com","authorization_servers":["https://id.paddle.com"],"bearer_methods_supported":["header"]}
$curl -si -X POST https://mcp.paddle.com/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'reproduced$ curl -si -X POST https://mcp.paddle.com/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'
HTTP/2 401
date: Tue, 15 Sep 2026 07:32:58 GMT
content-type: application/json
content-length: 30
access-control-allow-origin: *
www-authenticate: Bearer error="unauthorized", error_description="Authorization needed", resource_metadata="https://mcp.paddle.com/.well-known/oauth-protected-resource"
access-control-expose-headers: mcp-session-id,WWW-Authenticate
cf-placement: remote-HKG
vary: accept-encoding
set-cookie: __cf_bm=n4oEoZbwmgBHcrTHMYY09eu9jToK7GiDDYR39Oy_BHg-1789457577.8900988-1.0.1.1-jzIsnz59HW2yqv5TfVcSS_be2IVf5IT_qUJFudBFaJwnPuwAbNpaYvaFNQLIJd.I5qt9p6FxwW_RDB3jeF0GwWTNM0oQI3OdVcOsB5_GcJvfzeAZHv1mB6L.8p60bxqt; HttpOnly; SameSite=None; Secure; Path=/; Domain=paddle.com; Expires=Tue, 15 Sep 2026 08:02:58 GMT
strict-transport-security: max-age=31536000; includeSubDomains; preload
server: cloudflare
cf-ray: a3b5f0c5c801251c-SJC
{"error":"No [redacted] provided."}
$curl -s https://raw.githubusercontent.com/PaddleHQ/paddle-openapi/HEAD/v1/openapi.yaml | head -4reproduced$ curl -s https://raw.githubusercontent.com/PaddleHQ/paddle-openapi/HEAD/v1/openapi.yaml | head -4 openapi: 3.1.0 info: title: "Paddle API" version: "1.0"
Claims vs evidence — vendor claims reconciled against independent verdictsClaims vs evidence
5 of 22 testable claims verified · 2 contradicted → integrity 5/100
33 distinct capability claims found in Paddle’s own claimed-docs/GitHub materials, reconciled against our judge’s independent verdicts.
5
Verified
15
Unverified
2
Contradicted
14
Undersold
Verified (7)
“Hosted MCP server lets AI agents like Claude and Cursor connect directly to a Paddle account to perform actions”
“MCP server exposes a codemode interface (search/execute/report_missing_tool) to chain Paddle API calls in one JS invocation”
“Separate docs MCP server gives agents access to current documentation, the OpenAPI spec, and SDK references”
Point an agent at llms.txt or agent-oriented docsfullproof ↗
“Agent skills are standardized, agent-oriented integration instructions discoverable at a well-known URL”
Point an agent at llms.txt or agent-oriented docsfullproof ↗
“Official Node.js SDK integrates Paddle Billing with server-side JavaScript/TypeScript apps”
“Importable Postman collection lets you explore and test the Billing API interactively”
Explore an interactive API reference with runnable examplespartialproof ↗
“Public OpenAPI 3.1 spec maintained on GitHub for generating client libraries and API tooling”
Download a machine-readable API spec (OpenAPI or equivalent)fullproof ↗
Unverified (22)
“Checkout for one-time purchases and subscription signups via a Paddle.js widget”
Accept an online card payment within a day of signing uppartialproof ↗
“Checkout for one-time purchases and subscription signups via a Paddle.js widget”
Set up recurring subscription billing with plans, trials, upgrades, and prorationfullproof ↗
“Localized pricing pages showing country/currency-specific prices, estimated taxes, and discounts”
Charge customers in their local currencies and settle to my bank in mine with transparent FX handlingfullproof ↗
“Upgrade/downgrade subscriptions: add/remove addons, change billing interval, or switch plans”
Set up recurring subscription billing with plans, trials, upgrades, and prorationfullproof ↗
“Agent can investigate failed payments and resolve billing issues through the MCP server”
Have an agent monitor failed payments via API and webhooks and drive retries and dunning outreachpartialproof ↗
“Agent can generate reports and analyze revenue, refunds, and transaction patterns through the MCP server”
Have an agent pull payout and balance-transaction data via the API and reconcile each bank deposit to its underlying chargesfullproof ↗
“Agent can build/evolve a pricing model and process subscription upgrades, downgrades, pauses, and cancellations via MCP”
Have an agent provision a new product, price, and payment link via the API in a single sessionfullproof ↗
“Agent can build/evolve a pricing model and process subscription upgrades, downgrades, pauses, and cancellations via MCP”
Set up recurring subscription billing with plans, trials, upgrades, and prorationfullproof ↗
“Live MCP OAuth connections start with read-only access and can be granted broader scopes”
Issue scoped/least-privilege API credentials for an agentpartialproof ↗
“Destructive MCP operations aren't blocked but are flagged with warnings; least-privilege scoped API keys recommended”
Issue scoped/least-privilege API credentials for an agentpartialproof ↗
“Bearer-token API keys created in dashboard, with documented granular permissions and default scopes per endpoint”
Issue scoped/least-privilege API credentials for an agentpartialproof ↗
“API keys can be rotated automatically via AWS Secrets Manager or manually”
Issue scoped/least-privilege API credentials for an agentpartialproof ↗
“Webhooks push real-time notifications to your server for account events”
“Webhook payloads can be verified by generating your own signature and comparing it to Paddle's”
Rely on signed webhook deliveries with automatic retries, event logs, and replay to keep my system consistent with payment statepartialproof ↗
“Inline checkout lets you embed checkout and item/total details directly inside your own UI”
Embed customizable payment components directly in my own site or app instead of redirecting to a hosted pagefullproof ↗
“Overlay checkout presents a full prebuilt checkout overlay with minimal frontend code”
Redirect customers to a vendor-hosted, conversion-optimized checkout page without building my own payment UIfullproof ↗
“Subscriptions can be paused, stopping billing temporarily until resumed”
Set up recurring subscription billing with plans, trials, upgrades, and prorationfullproof ↗
“Sales team can draft and send invoices for subscriptions and collect payment manually”
Send hosted invoices with online payment and automatic reminderspartialproof ↗
“Built-in payment recovery lets you configure failure notifications, tactical retries, and past-due subscription handling”
Automatically retry failed subscription payments with smart dunning and recovery emailsfullproof ↗
“Detailed payout reconciliation reports itemize gross, tax, fees, and chargebacks to match bank deposits”
Reconcile settlements to bank deposits with itemized reports covering fees, refunds, and chargebacksfullproof ↗
“Built-in multi-currency support lets customers pay locally while you get paid in your own currency”
Charge customers in their local currencies and settle to my bank in mine with transparent FX handlingfullproof ↗
“Sandbox environment mirrors production for building/testing integrations without touching real data, with distinct prefixed keys”
Test against a sandbox environment without touching production datafullproof ↗
Contradicted (3)
“Localized pricing pages showing country/currency-specific prices, estimated taxes, and discounts”
Calculate and collect the correct sales tax, VAT, or GST on every transaction automaticallydisputedproof ↗
“Transactions can be created directly via the API or dashboard without going through checkout”
Create a shareable payment link from the dashboard with no code and start selling immediatelynoneproof ↗
“Merchant-of-record model lets you sell in 200+ countries fully tax compliant with no extra engineering, for an all-inclusive fee”
Calculate and collect the correct sales tax, VAT, or GST on every transaction automaticallydisputedproof ↗
Undersold (14)
Run the product headlessly / in CI for automationpartialproof ↗
Drive the product through a documented public APIfullproof ↗
Get AI-generated insights and suggestions from my data inside the productpartialproof ↗
Delegate tasks to a built-in AI assistant inside the productpartialproof ↗
Operate the product with natural-language commandsfullproof ↗
Perform bulk operations across many items at oncepartialproof ↗
Define rules that trigger actions automatically on eventspartialproof ↗
Offer digital wallets and local payment methods (Apple Pay, Google Pay, bank redirects, BNPL) from the same integrationpartialproof ↗
Keep my systems out of most of PCI DSS scope because card data is tokenized and never touches my serverspartialproof ↗
Integrate a working payment flow from the docs alone in under a day, with copy-paste examples in my languagefullproof ↗
Build and test the entire payment flow in a sandbox or test mode that mirrors production, with test cards for every scenario including declines and disputespartialproof ↗
Issue full or partial refunds from both the dashboard and the APIpartialproof ↗
Do everything through the API that I can do in the UIpartialproof ↗
Control the payout schedule and see exactly which charges, fees, and refunds make up each payoutpartialproof ↗
Claims outside our story set (4)
Real capability claims found in Paddle’s own materials, but no story in this arena’s taxonomy covers them yet — that’s feedback on the taxonomy, not a mark against the product.
“Official plugins bundle skills with the docs and account MCP servers for Claude Code, Codex, and Gemini CLI”
source ↗“Paddle publishes an LLM integration benchmark (23 models, 10 tasks) guiding agents to load skills first”
source ↗“API reference documents rate limiting per endpoint”
source ↗“Customer portal lets customers self-manage subscriptions, payments, and account info with no engineering effort”
source ↗
Business model
Merchant-of-record pricing: 5% + 50¢ per checkout transaction, all-inclusive (payments, global sales tax/VAT compliance, fraud, chargebacks, support); custom rates at volume.
pricing ↗Score trend
How this product’s scores have moved as evidence and verdicts are re-derived — a point per change, not per day.
Try Experimental
Run it in the microterminal →Recorded agent sessions — and a live MCP handshake where the vendor ships one.
Flag
⚑ Flag a verdictThink a verdict is wrong? Opens a prefilled GitHub issue — or use the ⚑ next to any verdict above.
For agents
