drafty
Paddle logo

Build a Paddle revenue dashboard with Claude

Connect the Paddle MCP server to Claude, ask for an MRR, subscriptions, and tax dashboard from your live numbers, and publish it to a link your team comments on directly — no BI tool, no screenshots pasted into Slack.

What you'll build
A self-contained revenue dashboard — MRR, active subscriptions, new vs. churned this month, gross volume, tax collected by region, recent transactions — generated by Claude from your real Paddle data, then published to a drafty.im/canvas/… link. Your team clicks the exact chart or number they want changed and leaves a note. Claude reads the comments and ships a revised version to the same URL.

This is an end-to-end example: connect a data source over MCP, generate a dashboard from live numbers, and close the review loop on one link. Total time, start to shared link, is under fifteen minutes. The same shape works for any of the other examples — only the connection step changes.

Here's the finished dashboard, published to a canvas — click any tile or number to leave a comment, exactly as your team would:

Live canvas — comment on any elementOpen ↗

The three moving parts

  1. The Paddle MCP server gives Claude read access to your Paddle account — subscriptions, transactions, customers, products, and reports — through a controlled set of tools. You approve what it can touch.
  2. Claude pulls the numbers and writes a single self-contained HTML dashboard. You iterate on it in the artifact panel until it's right.
  3. Drafty turns that HTML into a stable link your team reviews. Comments pin to the exact element; Claude ships the fix to the same URL.

The generation step is fast now. The part this example is really about is the third one — getting the dashboard in front of people without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the Paddle MCP server

Paddle runs an official remote MCP server at https://mcp.paddle.com/mcp. You connect once, authenticating with a Paddle API key passed as a Bearer token — generate the key in your Paddle dashboard under Developer tools → Authentication.

In Claude Code:

claude
claude mcp add --transport http paddle https://mcp.paddle.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Then run /mcp inside Claude Code to confirm the server connected. Paddle Billing keys are environment-bound — a sandbox key (pdl_sdbx_…) only hits sandbox, a live key only hits live — so use a live, read-scoped key for a real revenue dashboard.

In Claude Desktop: open Settings → Connectors → Add custom connector, point it at https://mcp.paddle.com/mcp, and add the same Authorization: Bearer YOUR_API_KEY header.

Safety first
Generate an API key scoped to read access only on the resources you need — subscriptions, transactions, customers, reports. This dashboard never writes to Paddle. Paddle's own guidance is to start read-only while you're evaluating and widen later; a reporting dashboard never needs to widen. Never paste the key into a committed file or a repo.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the MCP server's tools to search the Paddle API reference and execute read calls against your account:

claude
Using the Paddle MCP server, pull everything we need for a revenue dashboard: current MRR from active subscriptions, count of active subscriptions, new and canceled subscriptions in the last 30 days, gross transaction volume this month vs. last month, tax collected this month broken down by country, and the 10 most recent transactions. Summarize the figures before you build anything.

Claude calls Paddle, returns the figures, and you sanity-check them against the Paddle dashboard before going further. This is the moment to catch a wrong assumption — a sandbox key, a currency mix, paused subscriptions counted as active — while it's cheap.

Step 3 — Build the dashboard

Once the numbers look right, ask for the artifact:

claude
Build a single self-contained HTML dashboard from those figures. MRR as the hero number with month-over-month change, then tiles for active subscriptions, new vs. churned, and gross volume. A tax-by-country breakdown, since Paddle is the merchant of record and remits sales tax for us. A recent-transactions table at the bottom. Clean, no external dependencies — inline the CSS and any chart code.

Claude renders it live in the artifact panel. Iterate in place — you're not regenerating from scratch:

Step 4 — Publish to Drafty for review

A Claude artifact link is a preview, not a stable URL — iterate the artifact and the link you already sent now shows the old version. Ask Claude to publish it to a Drafty canvas instead, so the link you share always stays current:

claude
Publish this dashboard to Drafty as a canvas and give me the shareable link.

Claude pushes the dashboard and hands back a drafty.im/canvas/… link that renders on any device. Send it — your team opens it in a browser, no login and no Claude account needed.

Step 5 — The review loop

This is the part that's not obvious until you've done it once.

A reviewer clicks the specific tile, chart, or number they want changed and leaves a pinned comment — "this churn figure looks high, are we counting paused subscriptions as churned?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant Paddle query if needed, and pushes a revised dashboard to the same URL. The reviewer refreshes and sees the change; the thread stays attached to the element.

The mechanic matters because of what it removes. A Slack message about a chart produces "the number on the left looks wrong." A pinned comment on the actual tile produces "this — count paused subscriptions separately, not as churn." One of those produces a correct revision; the other produces a guess.

Keeping it fresh

An MCP-generated dashboard is a snapshot — it holds the numbers Claude pulled when it built it; it doesn't re-query Paddle when someone opens the link. For a weekly review or a board-ready snapshot, that's fine.

To make it a live canvas that always shows today's figures, copy this prompt — Claude sets up the refresh for you and schedules it to run on its own:

claude
Turn this Paddle dashboard into a live canvas: every morning, re-pull the latest numbers from Paddle via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows today's figures. Schedule it to run daily on its own.

The link stays stable while the content updates underneath it — see keeping a canvas updated automatically.

What to watch for

Paddle dashboard with Claude — FAQ

Do I need to paste my Paddle API key anywhere?
Yes — the Paddle MCP server authenticates with your API key as a Bearer token, generated under Developer tools → Authentication in the Paddle dashboard. Scope it to read access only and pass it in the connect command's Authorization header. Never commit it to a repo. Sandbox keys (pdl_sdbx_…) only hit sandbox and live keys only hit live, so use a live read-scoped key for a real revenue dashboard.
Is the dashboard live or a snapshot?
A snapshot. It contains the numbers Claude pulled when it built the file; it does not re-query Paddle when someone opens the link. To refresh it, ask Claude to repull and re-push to the same URL — or put that on a daily schedule so the stable link always shows current numbers.
Can my team comment without a Paddle or Claude account?
Yes. The dashboard is published to a Drafty canvas link that renders in any browser. Reviewers click the exact element they want changed and leave a pinned comment with no login required. Only the person connecting Paddle needs access to the account.
Is it safe to give Claude access to my Paddle account?
Connect with an API key scoped to read access, and a revenue dashboard never needs more than that. The MCP server flags destructive operations with warnings and you approve actions in Claude, but the cleanest guarantee for a reporting task is a read-only key — then there's nothing to write even if asked.
How is this different from Paddle's own reports and analytics?
Paddle's built-in reports and ProfitWell metrics query your live data inside the Paddle dashboard — the right choice for standing, governed reporting. This approach is for a fast, shareable snapshot you can spin up in minutes and iterate by talking to Claude, then collect feedback on inline. Different jobs: one is a standing system, the other is a quick reviewable deliverable.