Setup guide
Connect RevenueCat
RevenueCat connects with a project-scoped secret API key (v2) rather than OAuth. You generate the key in the RevenueCat dashboard and paste it into Modiva, which reads products, entitlements, offerings, packages, customers and their subscriptions and purchases through one unified API and MCP server, all over the RevenueCat REST API v2. A v2 secret key belongs to a single project, so Modiva auto-detects that project — there's nothing else to configure. The RevenueCat tools are read-only, so a connection can never change your catalog or customers.
Before you start
- A RevenueCat account with at least one project configured.
- A secret API key using API Version 2, created under Project settings → API keys → Secret API keys.
Step-by-step setup
- 1
Create a secret API key (v2)
In the RevenueCat dashboard open your project, go to API keys, and under "Secret API keys" click "+ New secret API key". Label it "Modiva", make sure it uses API Version 2, and copy the generated sk_… value — you won't be able to see it again. Secret keys are powerful, so never expose them in front-end code or public repositories.
- 2
Sign in to Modiva
Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.
- 3
Open Connections → New connection
In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social, Ads, CRM, E-commerce, Productivity and Payments).
- 4
Select RevenueCat and paste the key
Click the RevenueCat card. In the inline form paste the sk_… secret key. Leave Project ID blank to let Modiva auto-detect it, or set it explicitly if you prefer, then click Connect.
- 5
You're connected
Modiva validates the key against the RevenueCat v2 API and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace. If the key is wrong or lacks v2 access you'll see an error — re-check the key and try again.
What Modiva can access
The secret key you paste grants read access to your RevenueCat project. Modiva only reads the data the tools need, and never writes. You can revoke it any time by deleting the key in RevenueCat or disconnecting in Modiva.
- Read your project identity
- Read apps and products
- Read entitlements, offerings and packages
- Read customers, their subscriptions and purchases
Troubleshooting & FAQ
Does RevenueCat connect with OAuth or an API key?
With a RevenueCat v2 secret API key. RevenueCat's v2 REST API authenticates with a project secret key, which works today with no extra setup. You paste it once at connect time; Modiva encrypts it at rest with AES-256-GCM. RevenueCat also offers an OAuth flow for technology partners, which Modiva can adopt in future without changing how the tools work.
Where is my secret key stored?
Encrypted. Modiva stores the sk_… key with envelope encryption (AES-256-GCM) and only decrypts it in-memory to call the RevenueCat API. It is never exposed to the browser or logged.
Which project does the connection cover?
A v2 secret key belongs to exactly one RevenueCat project, so Modiva reads that project automatically from the key and scopes every tool to it. To connect another project, create a secret key in that project and add a second connection.
Can Modiva change my subscriptions, products or customers?
No. The RevenueCat tools are read-only today — they list and fetch products, entitlements, offerings, packages, customers, subscriptions and purchases. Write operations are not exposed.
How do I look up a specific customer?
Use the customer's app user id (the id you set in the RevenueCat SDK) with the customer tools to read that customer and list their subscriptions and purchases. An MCP-connected AI agent can do this on your behalf in plain language.
How do I disconnect?
Open Connections, click the RevenueCat row and choose Disconnect — Modiva deletes the stored key immediately. To fully revoke access, also delete the "Modiva" secret API key in the RevenueCat dashboard.
Need help with RevenueCat?
Reach the team any time from our support page, or ask Fin, our AI support agent.