Skip to content
Back to search

mcp-server-revenuecat

Multi-project MCP server for the RevenueCat REST API v2, with read-only mode

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dvcrn--mcp-server-revenuecat/badge.svg)](/listings/dvcrn--mcp-server-revenuecat)

HTML

<a href="/listings/dvcrn--mcp-server-revenuecat"><img src="/api/listings/dvcrn--mcp-server-revenuecat/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

mise

`mise` installs Go packages natively via the `go:` backend (binary name: `mcp-server-revenuecat`):

mise use -g go:github.com/dvcrn/mcp-server-revenuecat/cmd/mcp-server-revenuecat@latest

npm

Installs the `mcp-server-revenuecat` binary (or run without installing via `npx -y mcp-server-revenuecat`):

npm install -g mcp-server-revenuecat

go install

Installs the `mcp-server-revenuecat` binary into `$GOPATH/bin`:

go install github.com/dvcrn/mcp-server-revenuecat/cmd/mcp-server-revenuecat@latest

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 187 lines
  1. # mcp-server-revenuecat
  2. Multi-project MCP server for the RevenueCat REST API v2, written in Go.
  3. RevenueCat's hosted MCP (`https://mcp.revenuecat.ai/mcp`) relies on OAuth sessions whose tokens expire, which breaks unattended and background agents. `mcp-server-revenuecat` uses RevenueCat API v2 secret keys (`sk_...`) that do not expire, and exposes multiple projects behind a single stdio, HTTP, or Cloudflare Worker endpoint.
  4. ## Install
  5. ### mise
  6. `mise` installs Go packages natively via the `go:` backend (binary name: `mcp-server-revenuecat`):
  7. ```sh
  8. mise use -g go:github.com/dvcrn/mcp-server-revenuecat/cmd/mcp-server-revenuecat@latest
  9. ```
  10. ### npm
  11. Installs the `mcp-server-revenuecat` binary (or run without installing via `npx -y mcp-server-revenuecat`):
  12. ```sh
  13. npm install -g mcp-server-revenuecat
  14. ```
  15. ### go install
  16. Installs the `mcp-server-revenuecat` binary into `$GOPATH/bin`:
  17. ```sh
  18. go install github.com/dvcrn/mcp-server-revenuecat/cmd/mcp-server-revenuecat@latest
  19. ```
  20. ## Setup
  21. Create a gitignored `projects.json` from `projects.example.json`:
  22. ```sh
  23. cp projects.example.json projects.json
  24. ```
  25. ```json
  26. [
  27. { "alias": "ios_app", "name": "Dummy iOS App", "project_id": "proj1ab2c3d4", "api_key": "sk_dummy_projectA" },
  28. { "alias": "android_app", "name": "Dummy Android App", "project_id": "proj5ef6g7h8", "api_key": "sk_dummy_projectB" }
  29. ]
  30. ```
  31. Every project-scoped tool accepts either `alias` or `project_id`. `list_projects` returns `{alias, name, project_id}` without exposing `api_key`.
  32. Environment variables:
  33. | Variable | Required for | Description |
  34. | --- | --- | --- |
  35. | `REVENUECAT_PROJECTS` | always | JSON array of projects (the contents of `projects.json`) |
  36. | `MCP_TOKEN` | HTTP (unless `MCP_READ_TOKEN` is set) | Bearer token (`Authorization: Bearer <token>` or `X-API-Key`). Generate with `openssl rand -hex 32` |
  37. | `MCP_READ_TOKEN` | HTTP, optional | Separate bearer token restricted to read-only tools. Must differ from `MCP_TOKEN` |
  38. | `MCP_READ_ONLY` | optional | `1` or `true` restricts stdio and `MCP_TOKEN` to read-only tools |
  39. Example MCP client config (stdio):
  40. ```json
  41. {
  42. "mcpServers": {
  43. "revenuecat": {
  44. "command": "mcp-server-revenuecat",
  45. "env": {
  46. "MCP_READ_ONLY": "1",
  47. "REVENUECAT_PROJECTS": "[{\"alias\":\"ios_app\",\"name\":\"Dummy iOS App\",\"project_id\":\"proj1ab2c3d4\",\"api_key\":\"sk_dummy_projectA\"}]"
  48. }
  49. }
  50. }
  51. }
  52. ```
  53. ## Run locally
  54. Every install method provides the same `mcp-server-revenuecat` binary. Without installing, use `npx -y mcp-server-revenuecat` in its place, or `go run ./cmd/mcp-server-revenuecat` from a local checkout.
  55. Stdio (default):
  56. ```sh
  57. REVENUECAT_PROJECTS="$(cat projects.json)" npx -y mcp-server-revenuecat
  58. ```
  59. HTTP (`/mcp` and unauthenticated `GET /health`):
  60. ```sh
  61. REVENUECAT_PROJECTS="$(cat projects.json)" MCP_TOKEN="$(openssl rand -hex 32)" npx -y mcp-server-revenuecat -http :8080
  62. ```
  63. ## Run on Wrangler (Cloudflare Workers)
  64. Log in with `wrangler login` (or set `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID`), then upload secrets and deploy:
  65. ```sh
  66. wrangler secret put MCP_TOKEN
  67. wrangler secret put MCP_READ_TOKEN # optional
  68. mise run worker-projects # validates projects.json and sets REVENUECAT_PROJECTS
  69. wrangler deploy
  70. ```
  71. `wrangler deploy` builds the Go Wasm bundle automatically (`bun run build`). For local worker development, run `wrangler dev` (or `mise run dev` if using `fnox` for `.dev.vars`).
  72. Example `.mcp.json` for the deployed worker:
  73. ```json
  74. {
  75. "mcpServers": {
  76. "revenuecat": {
  77. "type": "http",
  78. "url": "https://<worker>.<subdomain>.workers.dev/mcp",
  79. "headers": { "Authorization": "Bearer ${MCP_TOKEN}" }
  80. }
  81. }
  82. }
  83. ```
  84. ## Tools
  85. ### Read-only (29)
  86. Available in all modes (`MCP_TOKEN`, `MCP_READ_TOKEN`, and `MCP_READ_ONLY=1`):
  87. | Tool | Endpoint | Description |
  88. | --- | --- | --- |
  89. | `list_projects` | local config | List configured `{alias, name, project_id}` entries |
  90. | `list_apps` | `GET /v2/projects/{project_id}/apps` | List apps in a project |
  91. | `get_app` | `GET /v2/projects/{project_id}/apps/{app_id}` | Get an app and its store configuration |
  92. | `get_overview_metrics` | `GET /v2/projects/{project_id}/metrics/overview` | Get overview metrics (active subscriptions, trials, MRR, revenue, active/new users) |
  93. | `get_chart_options` | `GET /v2/projects/{project_id}/charts/{chart_name}/options` | Get supported resolutions, segments, filters, and selectors for a chart |
  94. | `get_chart_data` | `GET /v2/projects/{project_id}/charts/{chart_name}` | Query chart time-series data and summary aggregations |
  95. | `list_customers` | `GET /v2/projects/{project_id}/customers` | List or search customers (`search` by email, user ID, or store transaction ID) |
  96. | `get_customer` | `GET /v2/projects/{project_id}/customers/{customer_id}` | Get a customer, active entitlements, and optional expanded `attributes` |
  97. | `list_customer_active_entitlements` | `GET /v2/projects/{project_id}/customers/{customer_id}/active_entitlements` | List active entitlements on a customer |
  98. | `list_customer_aliases` | `GET /v2/projects/{project_id}/customers/{customer_id}/aliases` | List aliases linked to a customer |
  99. | `list_customer_attributes` | `GET /v2/projects/{project_id}/customers/{customer_id}/attributes` | List attributes stored on a customer |
  100. | `list_customer_subscriptions` | `GET /v2/projects/{project_id}/customers/{customer_id}/subscriptions` | List a customer's subscriptions |
  101. | `search_subscriptions` | `GET /v2/projects/{project_id}/subscriptions` | Search subscriptions by `store_subscription_identifier` |
  102. | `get_subscription` | `GET /v2/projects/{project_id}/subscriptions/{subscription_id}` | Get a subscription by ID |
  103. | `list_subscription_entitlements` | `GET /v2/projects/{project_id}/subscriptions/{subscription_id}/entitlements` | List entitlements unlocked by a subscription |
  104. | `list_customer_purchases` | `GET /v2/projects/{project_id}/customers/{customer_id}/purchases` | List a customer's one-time purchases |
  105. | `search_purchases` | `GET /v2/projects/{project_id}/purchases` | Search one-time purchases by `store_purchase_identifier` |
  106. | `get_purchase` | `GET /v2/projects/{project_id}/purchases/{purchase_id}` | Get a one-time purchase by ID |
  107. | `list_purchase_entitlements` | `GET /v2/projects/{project_id}/purchases/{purchase_id}/entitlements` | List entitlements unlocked by a purchase |
  108. | `list_products` | `GET /v2/projects/{project_id}/products` | List products in a project, optionally filtered by `app_id` |
  109. | `get_product` | `GET /v2/projects/{project_id}/products/{product_id}` | Get a product by ID |
  110. | `list_entitlements` | `GET /v2/projects/{project_id}/entitlements` | List entitlements in a project |
  111. | `get_entitlement` | `GET /v2/projects/{project_id}/entitlements/{entitlement_id}` | Get an entitlement by ID |
  112. | `list_entitlement_products` | `GET /v2/projects/{project_id}/entitlements/{entitlement_id}/products` | List products attached to an entitlement |
  113. | `list_offerings` | `GET /v2/projects/{project_id}/offerings` | List offerings in a project |
  114. | `get_offering` | `GET /v2/projects/{project_id}/offerings/{offering_id}` | Get an offering by ID |
  115. | `list_offering_packages` | `GET /v2/projects/{project_id}/offerings/{offering_id}/packages` | List packages in an offering |
  116. | `get_package` | `GET /v2/projects/{project_id}/packages/{package_id}` | Get a package by ID |
  117. | `list_package_products` | `GET /v2/projects/{project_id}/packages/{package_id}/products` | List products and eligibility criteria attached to a package |
  118. ### Write (26)
  119. Available only when `MCP_READ_ONLY` is unset/`false` and (over HTTP) when authenticated with `MCP_TOKEN`:
  120. | Tool | Endpoint | Description |
  121. | --- | --- | --- |
  122. | `create_customer` | `POST /v2/projects/{project_id}/customers` | Create a customer with `id` and optional initial `attributes` |
  123. | `delete_customer` | `DELETE /v2/projects/{project_id}/customers/{customer_id}` | Permanently delete a customer |
  124. | `set_customer_attributes` | `POST /v2/projects/{project_id}/customers/{customer_id}/attributes` | Set or delete (`delete: true`) customer attributes |
  125. | `grant_customer_entitlement` | `POST /v2/projects/{project_id}/customers/{customer_id}/actions/grant_entitlement` | Grant a promotional entitlement until `expires_at` (Unix ms) |
  126. | `revoke_customer_entitlement` | `POST /v2/projects/{project_id}/customers/{customer_id}/actions/revoke_granted_entitlement` | Revoke an active promotional entitlement grant |
  127. | `assign_customer_offering` | `POST /v2/projects/{project_id}/customers/{customer_id}/actions/assign_offering` | Set (`offering_id`) or clear (`clear: true`) a customer offering override |
  128. | `transfer_customer` | `POST /v2/projects/{project_id}/customers/{customer_id}/actions/transfer` | Transfer subscriptions and purchases to `target_customer_id` |
  129. | `cancel_subscription` | `POST /v2/projects/{project_id}/subscriptions/{subscription_id}/actions/cancel` | Cancel an active Web Billing (`rc_billing`) subscription |
  130. | `refund_subscription` | `POST /v2/projects/{project_id}/subscriptions/{subscription_id}/actions/refund` | Refund the latest Web Billing subscription payment and revoke access |
  131. | `extend_subscription` | `POST /v2/projects/{project_id}/subscriptions/{subscription_id}/actions/extend` | Extend a subscription by `extend_by_days` or `extend_until_ms` |
  132. | `refund_purchase` | `POST /v2/projects/{project_id}/purchases/{purchase_id}/actions/refund` | Refund a Web Billing one-time purchase and revoke access |
  133. | `create_product` | `POST /v2/projects/{project_id}/products` | Create a product in a project |
  134. | `delete_product` | `DELETE /v2/projects/{project_id}/products/{product_id}` | Delete a product from a project |
  135. | `create_entitlement` | `POST /v2/projects/{project_id}/entitlements` | Create an entitlement |
  136. | `update_entitlement` | `POST /v2/projects/{project_id}/entitlements/{entitlement_id}` | Update an entitlement's `display_name` |
  137. | `delete_entitlement` | `DELETE /v2/projects/{project_id}/entitlements/{entitlement_id}` | Delete an entitlement |
  138. | `attach_entitlement_products` | `POST /v2/projects/{project_id}/entitlements/{entitlement_id}/actions/attach_products` | Attach products to an entitlement |
  139. | `detach_entitlement_products` | `POST /v2/projects/{project_id}/entitlements/{entitlement_id}/actions/detach_products` | Detach products from an entitlement |
  140. | `create_offering` | `POST /v2/projects/{project_id}/offerings` | Create an offering |
  141. | `update_offering` | `POST /v2/projects/{project_id}/offerings/{offering_id}` | Update an offering's `display_name`, promote it with `is_current: true`, or set/clear `metadata` |
  142. | `delete_offering` | `DELETE /v2/projects/{project_id}/offerings/{offering_id}` | Delete a non-default offering and its packages |
  143. | `create_offering_package` | `POST /v2/projects/{project_id}/offerings/{offering_id}/packages` | Create a package inside an offering |
  144. | `update_package` | `POST /v2/projects/{project_id}/packages/{package_id}` | Update a package's `display_name` or `position` |
  145. | `delete_package` | `DELETE /v2/projects/{project_id}/packages/{package_id}` | Delete a package |
  146. | `attach_package_products` | `POST /v2/projects/{project_id}/packages/{package_id}/actions/attach_products` | Attach products and eligibility criteria to a package |
  147. | `detach_package_products` | `POST /v2/projects/{project_id}/packages/{package_id}/actions/detach_products` | Detach products from a package |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.