Skip to main content
Glama
RevenueDot MCP

RevenueDot MCP

Official
by revenuedot

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

npm License: MIT Hosted

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.

Watch the 87-second demo of RevenueDot in ChatGPT

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, so npx -y @revenuedot/mcp runs 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

  1. Secret key (bearer). Authorization: Bearer sk_... is passed to the RevenueDot REST API v2, which checks the key's project and scopes.

  2. 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 as OAuth: <client name> and you revoke it there. This server publishes /.well-known/oauth-protected-resource and answers 401 with WWW-Authenticate so 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

list-projects

Projects this key or connection can use

GET /v2/projects

list-apps

Apps, one per store

GET /apps

create-app

Adds a Test Store, App Store (bundle id) or Google Play (package name) app; no credentials

POST /apps

list-public-api-keys

The app's public SDK key (appl_, goog_, test_), which ships inside the app

GET /apps/{id}/public_api_keys

list-products

Products, optionally for one app

GET /products

create-product

Adds a store product to an app

POST /products

list-entitlements

Entitlements with their products

GET /entitlements

create-entitlement

Adds an entitlement such as pro

POST /entitlements

attach-products-to-entitlement

Makes products unlock an entitlement

POST /entitlements/{id}/actions/attach_products

list-offerings

Offerings with packages and products

GET /offerings

create-offering

Adds an offering, optionally current

POST /offerings

create-packages

Adds a package to an offering

POST /offerings/{id}/packages

attach-products-to-package

Puts products in a package

POST /packages/{id}/actions/attach_products

get-customer

Customer, active entitlements, attributes, subscriptions, purchases

GET /customers/{id} and sub-resources

grant-customer-entitlement

Promotional access until a date (creates the customer if new)

POST /customers/{id}/actions/grant_entitlement

revoke-customer-entitlement

Ends granted access

POST /customers/{id}/actions/revoke_granted_entitlement

list-webhook-integrations

Webhooks

GET /integrations/webhooks

create-webhook-integration

Adds a webhook

POST /integrations/webhooks

get-import-status

Customers, subscriptions and pending Google tokens after npx revenuedot import

GET /import/status

get-project-health

Per app: do the store credentials work, do notifications arrive; are webhooks delivered

GET /setup_health

get-metrics

Overview cards, or one metric's daily history

GET /metrics/overview, /metrics/history

list-customers

Newest first, or search by app user id, email or transaction id

GET /customers

list-transactions

Purchases, renewals, trials and refunds

GET /transactions

list-events

The event log (the events webhooks send), by customer, type or environment

GET /events

set-customer-attributes

Sets or deletes attributes (destructive: it overwrites)

POST /customers/{id}/attributes

delete-customer

Deletes a customer's data (destructive)

DELETE /customers/{id}

extend-subscription

Free days, or until a date

POST /subscriptions/{id}/actions/extend

cancel-subscription

Cancels at period end (destructive)

POST /subscriptions/{id}/actions/cancel

refund-subscription

Refunds and ends access (destructive)

POST /subscriptions/{id}/actions/refund

create-test-purchase

Simulates a Test Store purchase lifecycle

POST /test_purchases

archive-offering

Hides an offering (destructive)

POST /offerings/{id}/actions/archive

list-webhook-deliveries

Delivery attempts, by status

GET /webhooks/{id}/deliveries

retry-webhook-delivery

Sends a delivery again

POST /webhooks/{id}/deliveries/{id}/retry

send-test-webhook

Sends a TEST event

POST /integrations/webhooks/{id}/test

delete-webhook-integration

Deletes a webhook (destructive)

DELETE /integrations/webhooks/{id}

verify-store-credentials

Calls Apple or Google with the saved key and reports whether it works

POST /apps/{id}/actions/verify_credentials

get-app-store-settings

Notification URL for App Store Connect or Pub/Sub, forward URL, last notification and forward; credentials only as configured or not

GET /apps/{id}/store_settings

update-app

Renames an app, sets or clears notification_forward_url, sets track_new_purchases; no credentials (destructive: it changes where store notifications go)

POST /apps/{id}

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

project:read

Read everything

the 17 read-only tools

project:write

Create and update apps, change the catalog, grant and revoke access, manage webhooks, delete customers

17 tools (12 writes, 5 destructive)

project:support

Cancel, refund and extend subscriptions, make Test Store purchases. Asked for separately, only when a tool needs it

extend-subscription, cancel-subscription, refund-subscription, create-test-purchase

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:

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 tools
archive-offeringArchive offeringA
Destructive
Inspect

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 entitlementA
Idempotent
Inspect

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 packageB
Idempotent
Inspect

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 subscriptionA
Destructive
Inspect

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 customerA
Destructive
Inspect

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 webhookA
Destructive
Inspect

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 settingsA
Read-onlyIdempotent
Inspect

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 customerA
Read-onlyIdempotent
Inspect

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 statusA
Read-onlyIdempotent
Inspect

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 metricsA
Read-onlyIdempotent
Inspect

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 healthA
Read-onlyIdempotent
Inspect

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 customerA
Idempotent
Inspect

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 appsA
Read-onlyIdempotent
Inspect

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 customersA
Read-onlyIdempotent
Inspect

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 entitlementsB
Read-onlyIdempotent
Inspect

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 eventsA
Read-onlyIdempotent
Inspect

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 offeringsB
Read-onlyIdempotent
Inspect

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 productsB
Read-onlyIdempotent
Inspect

Lists the project's products (store product ids per app), optionally for one app.

Inputs: limit, app_id, project_id, starting_after.

list-projectsList projectsA
Read-onlyIdempotent
Inspect

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 keysA
Read-onlyIdempotent
Inspect

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 transactionsA
Read-onlyIdempotent
Inspect

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 deliveriesA
Read-onlyIdempotent
Inspect

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 webhooksB
Read-onlyIdempotent
Inspect

Lists the project's webhook integrations (URL, environment and event filters).

Inputs: limit, project_id, starting_after.

refund-subscriptionRefund subscriptionA
Destructive
Inspect

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 deliveryA
Idempotent
Inspect

Sends a failed or pending webhook delivery again now.

Inputs: webhook_id (required), delivery_id (required), project_id.

revoke-customer-entitlementRevoke granted entitlementA
Destructive
Inspect

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 attributesB
DestructiveIdempotent
Inspect

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 appA
Idempotent
Inspect

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 credentialsA
Read-onlyIdempotent
Inspect

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

    A3.5/5.0

    Scored across 38 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for RevenueCat that lets AI agents query subscriber data, check entitlements, fetch offerings, and manage subscriptions via natural language.
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      5
      5 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT