RevenueDot MCP
OfficialRevenueDot MCP gives AI assistants 38 tools to set up and operate a RevenueDot (open-source RevenueCat alternative) project — catalog, customers, access, webhooks and revenue metrics — over OAuth or a scoped secret key.
Catalog setup: create apps (Test Store, App Store, Google Play) and read their public SDK keys; create products, entitlements, offerings and packages, and attach products to each other (
create-app,list-public-api-keys,create-product,create-entitlement,create-offering,create-packages,attach-*).Browse the project: list projects, apps, products, entitlements, offerings and webhooks (
list-projects,list-apps,list-products,list-entitlements,list-offerings,list-webhook-integrations).Customers and support: find customers by app user id, email or transaction id, read their entitlements, attributes, subscriptions and purchases; search transactions and the event log (
list-customers,get-customer,list-transactions,list-events).Manage access: grant time-limited promotional entitlements, extend subscriptions by days or until a date, cancel at period end, refund, and revoke grants (
grant-customer-entitlement,extend-subscription,cancel-subscription,refund-subscription,revoke-customer-entitlement).Destructive ops (confirm first): delete a customer's data, overwrite customer attributes, archive an offering, delete a webhook, cancel/refund subscriptions.
Webhooks: create integrations (signing secret shown once), inspect and retry deliveries, send a TEST event, delete integrations (
create-webhook-integration,list-webhook-deliveries,retry-webhook-delivery,send-test-webhook,delete-webhook-integration).Health and diagnostics: check per-app store credentials and notification delivery, verify Apple/Google credentials, read App Store/Pub-Sub notification and forward settings, and inspect webhook delivery (
get-project-health,verify-store-credentials,get-app-store-settings).Metrics and migration: overview cards (MRR, revenue, active subs/trials, customers) or per-metric daily history, plus RevenueCat import status (
get-metrics,get-import-status).Testing: simulate Test Store purchase lifecycles (purchase, trial, renewal, cancel, billing issue, refund, expire) without touching Apple or Google (
create-test-purchase).App maintenance: rename an app, set/clear notification forwarding, toggle track_new_purchases (
update-app).Permissions: key or OAuth scopes gate everything —
project:read(17 read-only tools),project:write(catalog, grants, webhooks, deletes),project:support(extend/cancel/refund/test purchases); tools needing more return an error with the missing scope.Not possible: no tool accepts or returns store keys, passwords or webhook headers — credentials are entered in the dashboard; no tool creates secret API keys or changes billing/account settings.
Deploys the MCP server as a Cloudflare Worker using the cf CLI and cloudflare.config.ts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RevenueDot MCP grant user_42 the pro entitlement for 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RevenueDot MCP server
Connect Claude, ChatGPT, Cursor and other AI assistants to RevenueDot, the open-source RevenueCat alternative. 38 tools to set up apps, products, entitlements and offerings, find customers, grant access and check webhooks, hosted at mcp.revenuedot.app or run locally.
Main repository · Docs · Agent skills · Start for free on RevenueDot Cloud
Learn more: RevenueCat MCP server, official and open source: config for Claude Code, Claude, Codex, Cursor, ChatGPT and Windsurf, the tool table, the approval model, and what RevenueCat's own MCP server offers.

The server has 38 tools to create apps and read their SDK keys and store notification settings, set up products, entitlements, offerings and packages, find customers and read their history, grant, extend, cancel or refund, add and debug webhooks, check store credentials, read revenue metrics and follow an import from RevenueCat. It is also the server behind the RevenueDot ChatGPT plugin and Claude connector (install: revenuedot/agent-skills). Tool names match RevenueCat's MCP tools where the tool does the same thing, so prompts written for RevenueCat work here.
Status (2026-09-30): the hosted server is live at
https://mcp.revenuedot.app/mcp, in front of RevenueDot Cloud (https://api.revenuedot.app). The local server is published on npm as@revenuedot/mcp, sonpx -y @revenuedot/mcpruns the latest release.
Connect
Hosted (Streamable HTTP): https://mcp.revenuedot.app/mcp. Your client signs you in with OAuth, or you send Authorization: Bearer sk_.... https://mcp.revenuedot.app/claude/mcp (the Claude connector) serves the same 38 tools. https://mcp.revenuedot.app/chatgpt/mcp (the ChatGPT plugin) serves 37: it leaves out refund-subscription, because OpenAI does not list plugins that move money.
Free knowledge server, no sign-in: https://mcp.revenuedot.app/kit/mcp serves six read-only tools (search-monetization-knowledge, list-paywall-patterns, get-paywall-pattern, get-store-guideline, get-code-snippet, list-skills) with sourced paywall patterns, App Store and Google Play rules and code snippets. It needs no account or key, never calls a RevenueDot project, and every result ends with a line saying RevenueDot maintains it. It is the free half of the RevenueDot App Monetization plugin in revenuedot/agent-skills. The data lives in src/kit/data/.
Local (stdio), for RevenueDot Cloud or your own server (REVENUEDOT_URL defaults to https://api.revenuedot.app):
# Claude Code
claude mcp add revenuedot -e REVENUEDOT_API_KEY=sk_... -e REVENUEDOT_URL=https://your-server -- npx -y @revenuedot/mcp{
"mcpServers": {
"revenuedot": {
"command": "npx",
"args": ["-y", "@revenuedot/mcp"],
"env": { "REVENUEDOT_API_KEY": "sk_...", "REVENUEDOT_URL": "https://your-server" }
}
}
}Create the secret key under API keys in the RevenueDot dashboard. Give it only the permissions you want the assistant to have: a key with read scopes only cannot change anything, and a tool call that needs more gets an error naming the missing permission.
Self-hosted HTTP: npx -y @revenuedot/mcp --http --port 8788 --url https://your-server serves http://127.0.0.1:8788/mcp. Put it behind your reverse proxy with --host 0.0.0.0 --public-url https://mcp.your-domain. OAuth works against your own server too: it is the authorization server.
Related MCP server: revenuecat-charts-mcp
Auth
Secret key (bearer).
Authorization: Bearer sk_...is passed to the RevenueDot REST API v2, which checks the key's project and scopes.OAuth 2.1. The RevenueDot server is the authorization server (
/.well-known/oauth-authorization-server, dynamic client registration, authorization code with PKCE S256). The consent screen uses your dashboard session: you pick one project and read-only or read-and-write access. The access token is a secret key limited to that project and those scopes. It is listed under API keys asOAuth: <client name>and you revoke it there. This server publishes/.well-known/oauth-protected-resourceand answers401withWWW-Authenticateso clients find the sign-in on their own.
Tools
Every tool takes an optional project_id. Leave it out when the key or connection has one project.
Tool | What it does | API v2 call |
| Projects this key or connection can use |
|
| Apps, one per store |
|
| Adds a Test Store, App Store (bundle id) or Google Play (package name) app; no credentials |
|
| The app's public SDK key ( |
|
| Products, optionally for one app |
|
| Adds a store product to an app |
|
| Entitlements with their products |
|
| Adds an entitlement such as |
|
| Makes products unlock an entitlement |
|
| Offerings with packages and products |
|
| Adds an offering, optionally current |
|
| Adds a package to an offering |
|
| Puts products in a package |
|
| Customer, active entitlements, attributes, subscriptions, purchases |
|
| Promotional access until a date (creates the customer if new) |
|
| Ends granted access |
|
| Webhooks |
|
| Adds a webhook |
|
| Customers, subscriptions and pending Google tokens after |
|
| Per app: do the store credentials work, do notifications arrive; are webhooks delivered |
|
| Overview cards, or one metric's daily history |
|
| Newest first, or search by app user id, email or transaction id |
|
| Purchases, renewals, trials and refunds |
|
| The event log (the events webhooks send), by customer, type or environment |
|
| Sets or deletes attributes (destructive: it overwrites) |
|
| Deletes a customer's data (destructive) |
|
| Free days, or until a date |
|
| Cancels at period end (destructive) |
|
| Refunds and ends access (destructive) |
|
| Simulates a Test Store purchase lifecycle |
|
| Hides an offering (destructive) |
|
| Delivery attempts, by status |
|
| Sends a delivery again |
|
| Sends a TEST event |
|
| Deletes a webhook (destructive) |
|
| Calls Apple or Google with the saved key and reports whether it works |
|
| Notification URL for App Store Connect or Pub/Sub, forward URL, last notification and forward; credentials only as configured or not |
|
| Renames an app, sets or clears |
|
No tool accepts a key, password or credential: store keys and webhook headers are entered in the dashboard. Creating a webhook returns its signing secret once.
OAuth scopes
Scope | Lets the assistant | Tools |
| Read everything | the 17 read-only tools |
| Create and update apps, change the catalog, grant and revoke access, manage webhooks, delete customers | 17 tools (12 writes, 5 destructive) |
| Cancel, refund and extend subscriptions, make Test Store purchases. Asked for separately, only when a tool needs it |
|
A tool that needs more than the connection has returns an error with _meta["mcp/www_authenticate"], which ChatGPT and Claude use to ask you for the missing access. Every tool descriptor also carries _meta.securitySchemes.
scripts/verify-live.mjs checks a deployed server against the directories' rules (REVENUEDOT_MCP_TOKEN=sk_... node scripts/verify-live.mjs).
Entitlements can be named by id or lookup key. expires_at takes milliseconds, an ISO date or a duration such as 30d.
Use the tools without MCP
The tool definitions and executors depend only on zod and a small API client, so an in-app agent can reuse them:
import { createClient } from "@revenuedot/mcp";
import { tools, runTool } from "@revenuedot/mcp/tools";
const client = createClient({ baseUrl: "https://api.revenuedot.app", apiKey: process.env.REVENUEDOT_API_KEY! });
await runTool(client, "grant-customer-entitlement", { customer_id: "user_42", entitlement_id: "pro", expires_at: "30d" });Use with your coding agent
Coding agents can read this repository on demand, so they use the right package, imports and API:
Context7: https://context7.com/revenuedot/mcp
DeepWiki: https://deepwiki.com/revenuedot/mcp
GitMCP: https://gitmcp.io/revenuedot/mcp
Develop
pnpm install
pnpm test # starts a real RevenueDot server from ../revenuedot (or REVENUEDOT_REPO) on in-memory Postgres
pnpm typecheck
pnpm dev # HTTP on :8788 against REVENUEDOT_URL
pnpm run deploy # Cloudflare Worker with the cf CLI (cloudflare.config.ts, Circo account); needs Node 22.18+Use Node 24. CI (.github/workflows/ci.yml) runs typecheck, build and tests on every push and pull request. On main it then deploys mcp.revenuedot.app with the production environment's secrets and checks it live with scripts/verify-live.mjs: the protected resource metadata answers and POST /mcp without a token answers 401. Pushing to main is a production deploy.
RevenueDot is not affiliated with RevenueCat, Inc.
Available Tools
38 toolsarchive-offeringArchive offeringADestructiveInspect
Hides an offering from apps without deleting it (it can be unarchived in the dashboard). The current offering cannot be archived.
Inputs: offering_id (required), project_id.
attach-products-to-entitlementAttach products to entitlementAIdempotentInspect
Makes products unlock an entitlement. Attach every store's version of a plan (iOS, Android, Test Store).
Inputs: product_ids (required), entitlement_id (required), project_id.
attach-products-to-packageAttach products to packageBIdempotentInspect
Puts products in a package, at most one per app (e.g. the iOS, Android and Test Store monthly products in $rc_monthly).
Inputs: package_id (required), product_ids (required), project_id, eligibility_criteria.
cancel-subscriptionCancel subscriptionADestructiveInspect
Cancels a subscription at the end of the paid period (the customer keeps access until then). Works where the store lets a server cancel (Google Play); others answer with an error that says so. Ask the user to confirm first.
Inputs: subscription_id (required), project_id.
create-appCreate appAInspect
Creates an app in the project: test_store (simulated purchases, no store account needed), app_store with its bundle_id, or play_store with its package_name. Store credentials are not set here: the user adds them in the dashboard. Then call list-public-api-keys for the key the SDK uses.
Inputs: name (required), type (required), bundle_id, project_id, +1 more.
create-entitlementCreate entitlementCInspect
Creates an entitlement. lookup_key is what the app checks, e.g. customerInfo.entitlements["pro"].
Inputs: lookup_key (required), display_name (required), project_id.
create-offeringCreate offeringAInspect
Creates an offering (a set of packages the paywall shows). The project's first offering becomes current; set is_current to make this one current.
Inputs: lookup_key (required), display_name (required), metadata, is_current, +1 more.
create-packagesCreate packageAInspect
Creates a package in an offering. Use RevenueCat's standard lookup keys where they fit: $rc_monthly, $rc_annual, $rc_weekly, $rc_lifetime, $rc_six_month, $rc_three_month, $rc_two_month. Then attach products with attach-products-to-package.
Inputs: lookup_key (required), offering_id (required), display_name (required), position, +1 more.
create-productCreate productBInspect
Creates a product for one app. store_identifier is the product id in the store (App Store product id, Play subscription id such as pro:monthly, or any id for the Test Store). Set subscription_duration for subscriptions.
Inputs: type (required), app_id (required), store_identifier (required), project_id, +2 more.
create-test-purchaseCreate Test Store purchaseAInspect
Simulates a purchase lifecycle in the project's Test Store for one app user, through the same pipeline as a real purchase (events, transactions, webhooks). Never touches Apple or Google. Use it to check that entitlements and webhooks work.
Inputs: product_id (required), app_user_id (required), scenario, project_id, +1 more.
create-webhook-integrationCreate webhookAInspect
Adds a webhook that receives RevenueCat-format events (INITIAL_PURCHASE, RENEWAL, CANCELLATION, EXPIRATION ...). The response includes the signing secret once: tell the user to store it now, it cannot be shown again. A custom Authorization header for the endpoint is set in the dashboard.
Inputs: url (required), name (required), app_id, project_id, +2 more.
delete-customerDelete customerADestructiveInspect
Permanently deletes a customer and their data from this project (for a data-deletion request). Store subscriptions are not cancelled. Ask the user to confirm the app user id first.
Inputs: customer_id (required), project_id.
delete-webhook-integrationDelete webhookADestructiveInspect
Deletes a webhook integration and its delivery history. Events stop being sent to its URL.
Inputs: webhook_id (required), project_id.
extend-subscriptionExtend subscriptionAInspect
Adds time to a subscriber's existing subscription for support or goodwill: by days, or until a date. Works on Google Play and App Store subscriptions (App Store needs a reason and at most 90 days). Take the subscription id from get-customer.
Inputs: subscription_id (required), reason, project_id, extend_until, +1 more.
get-app-store-settingsGet app store settingsARead-onlyIdempotentInspect
An app's store notification setup: notification_url (paste it into App Store Connect or the Google Play Pub/Sub push subscription), notification_forward_url, when the last notification arrived and whether it was processed, the last forward, and track_new_purchases. Credentials show only whether each one is configured.
Inputs: app_id (required), project_id.
get-customerGet customerARead-onlyIdempotentInspect
Looks up a customer by app user id: active entitlements, attributes, subscriptions (gives_access says whether each one grants access now) and one-time purchases.
Inputs: customer_id (required), project_id.
get-import-statusGet import statusARead-onlyIdempotentInspect
After npx revenuedot import from RevenueCat: how many customers and subscriptions the project holds, and how many Google Play subscriptions still wait for a purchase token (per app).
Inputs: project_id.
get-metricsGet revenue metricsARead-onlyIdempotentInspect
Without metric: the overview cards (MRR, revenue, active subscriptions, active trials, new customers, active customers, last 28 days, USD). With metric: that metric's daily history over days days.
Inputs: days, metric, project_id, environment.
get-project-healthGet project healthARead-onlyIdempotentInspect
Setup health in one call: for each app whether the store credentials work and notifications arrive, plus whether webhooks are being delivered. Use it first when something looks wrong.
Inputs: project_id.
grant-customer-entitlementGrant entitlement to customerAIdempotentInspect
Grants a customer time-limited access to an entitlement until expires_at, for support or goodwill. The access ends by itself and can be revoked with revoke-customer-entitlement. The customer is created if new. Granting again with the same end date does nothing.
Inputs: expires_at (required), customer_id (required), entitlement_id (required), project_id.
list-appsList appsARead-onlyIdempotentInspect
Lists the project's apps (one per store: app_store, play_store, test_store, stripe ...), with their ids. Product creation needs an app id.
Inputs: limit, project_id, starting_after.
list-customersFind customersARead-onlyIdempotentInspect
Newest customers first, or a search: an exact app user id, the $email attribute, or a store transaction id. Use it to find who a support request is about, then call get-customer.
Inputs: limit, search, project_id, starting_after.
list-entitlementsList entitlementsBRead-onlyIdempotentInspect
Lists the project's entitlements (access levels such as pro) with the products that unlock each one.
Inputs: limit, project_id, starting_after.
list-eventsList eventsARead-onlyIdempotentInspect
The event log, newest first: the same events webhooks send (INITIAL_PURCHASE, RENEWAL, CANCELLATION, BILLING_ISSUE, EXPIRATION ...). Filter by customer, type or environment to see why a customer lost access.
Inputs: limit, types, project_id, customer_id, +2 more.
list-offeringsList offeringsBRead-onlyIdempotentInspect
Lists the project's offerings with their packages and each package's products. The current offering (is_current) is what the SDK shows by default.
Inputs: limit, project_id, starting_after.
list-productsList productsBRead-onlyIdempotentInspect
Lists the project's products (store product ids per app), optionally for one app.
Inputs: limit, app_id, project_id, starting_after.
list-projectsList projectsARead-onlyIdempotentInspect
Lists the RevenueDot projects this key or account can use. A secret key sees its own project; an OAuth connection sees the project the user picked.
Inputs: limit, starting_after.
list-public-api-keysList public SDK keysARead-onlyIdempotentInspect
Lists an app's public SDK key (appl_..., goog_..., test_...), the key the RevenueCat SDK is configured with in the app. It is public and ships inside the app; it is not a secret key and cannot change anything.
Inputs: app_id (required), project_id.
list-transactionsList transactionsARead-onlyIdempotentInspect
Every purchase, renewal, trial start and refund, newest first, with price and USD revenue. Optionally one customer's or one environment's.
Inputs: limit, project_id, customer_id, environment, +1 more.
list-webhook-deliveriesList webhook deliveriesARead-onlyIdempotentInspect
Delivery attempts for one webhook, newest first, with status, attempts, HTTP status and last error. Filter by status to find failures.
Inputs: webhook_id (required), limit, status, project_id, +1 more.
list-webhook-integrationsList webhooksBRead-onlyIdempotentInspect
Lists the project's webhook integrations (URL, environment and event filters).
Inputs: limit, project_id, starting_after.
refund-subscriptionRefund subscriptionADestructiveInspect
Refunds the latest charge and ends access immediately. Works where the store lets a server refund (Google Play); others answer with an error that says so. Money moves: only call it after the user said yes to this exact customer and amount.
Inputs: subscription_id (required), project_id.
retry-webhook-deliveryRetry webhook deliveryAIdempotentInspect
Sends a failed or pending webhook delivery again now.
Inputs: webhook_id (required), delivery_id (required), project_id.
revoke-customer-entitlementRevoke granted entitlementADestructiveInspect
Ends promotional access that was granted to a customer (with grant-customer-entitlement or the dashboard). Store purchases are not affected.
Inputs: customer_id (required), entitlement_id (required), project_id.
send-test-webhookSend test webhookAInspect
Sends a TEST event to a webhook integration so the user can see it arrive. The webhook must be enabled.
Inputs: webhook_id (required), project_id.
set-customer-attributesSet customer attributesBDestructiveIdempotentInspect
Sets attributes on a customer ($email, $displayName, or your own keys). A null value deletes the attribute.
Inputs: attributes (required), customer_id (required), project_id.
update-appUpdate appAIdempotentInspect
Changes an app's name and, for App Store and Google Play apps, notification_forward_url (store notifications are copied there, e.g. to RevenueCat during a migration; an empty string or null turns forwarding off) and track_new_purchases (record purchases the SDK never reported). Store credentials are not changed here: the user enters them in the dashboard.
Inputs: app_id (required), name, project_id, track_new_purchases, +1 more.
verify-store-credentialsVerify store credentialsARead-onlyIdempotentInspect
Checks the Apple or Google credentials already saved for an app by calling the store, and says whether they work. It never accepts or returns a key: credentials are entered in the dashboard.
Inputs: app_id (required), project_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Most tools have clearly distinct targets and actions, and descriptions sharply separate similar areas such as products vs packages, entitlements vs subscriptions, and webhook integrations vs deliveries. A few support-oriented tools like grant-customer-entitlement and extend-subscription overlap conceptually, but the descriptions provide enough distinction.
Nearly all names follow a consistent verb_noun hyphenated pattern, e.g. list-products, create-app, get-customer, delete-webhook-integration. Minor singular/plural differences match the object naturally and do not break predictability.
38 tools is well above the typical 3-15 sweet spot and lands in the 'too many' range for an MCP server. The domain is broad, but the surface is heavy enough to burden tool selection and likely includes lower-frequency operations that could be consolidated.
The server covers core RevenueCat-style lifecycle operations across projects, apps, products, entitlements, offerings, customers, subscriptions, webhooks, metrics, and events. Some lifecycle gaps remain, such as updating or deleting products/entitlements/offerings and updating webhook integrations, but most agent workflows are supported.
Maintenance
Related MCP Connectors
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Hosted Stripe MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server for Lemon Squeezy — stores, products, orders, subscriptions, license keys.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for RevenueCat that lets AI agents query subscriber data, check entitlements, fetch offerings, and manage subscriptions via natural language.6MIT
- AlicenseAqualityDmaintenanceAn MCP server that gives AI agents access to RevenueCat's Charts & Metrics API. Query MRR, churn, trial conversion, revenue, and 17 more subscription metrics directly from Claude, Cursor, or any MCP client.55 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants like Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through natural language, with a hosted OAuth server or a local stdio package. Also supports generating MCP tools from any OpenAPI spec.2,530 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI clients such as Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through natural language, using a hosted OAuth-authenticated endpoint or a local stdio package. It also ships an OpenAPI codegen tool for generating MCP tools from any OpenAPI spec.2,530 npmMIT