# RevenueCat MCP for subscription management. AI Agent Connect > RevenueCat MCP lets you operate your in-app purchase and subscription infrastructure directly through your AI client. Instead of jumping between support tickets and the RevenueCat dashboard, you can use natural language to look up customers, grant or revoke entitlements, manage products, and handle subscription lifecycles via the RevenueCat REST API v2. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_cBPlZawAdchJRJWjWESrRq3XmLwpcVQAhXUiLd15/ai-agent-connect - **Tags:** subscriptions, in-app-purchases, entitlements, revenuecat, mobile-monetization, subscription-management, customer-access, api-integration ## Description You can stop context-switching to the RevenueCat dashboard every time a customer has a billing issue. This MCP connects your AI agent directly to your subscription data, allowing you to handle support and configuration tasks through a chat interface. If a user needs a trial extension, you can grant it instantly. If a customer is asking about their current plan, you can pull their status without digging through logs. You can also manage your product catalog, including entitlements and offerings, by talking to your agent. It turns your AI client into a functional extension of your revenue operations, making it easy to handle promotional grants, customer transfers, and subscription adjustments in one place. ## Tools ### rc_attach_products_to_entitlement Links specific products to an entitlement so that buying them grants access. This changes live access for new purchases, so check your scope first. ### rc_cancel_subscription Stops a web-managed subscription from renewing at the end of the period. This does not trigger a refund. ### rc_create_customer Creates a new customer profile in RevenueCat with an ID and optional attributes. ### rc_create_entitlement Sets up a new entitlement within your project. ### rc_detach_products_from_entitlement Removes products from an entitlement, which prevents new purchases of those products from granting access. ### rc_extend_subscription Lengthens a subscription's billing period by a set number of days or until a specific date. ### rc_get_customer Retrieves a specific customer's details and attributes using their ID. ### rc_get_discount Fetches details for a specific discount, including its codes and eligibility. ### rc_get_entitlement Returns the details of a specific entitlement, including its attached products. ### rc_get_offering Gets the details of an offering, including its associated packages and products. ### rc_get_product Retrieves information for a specific product using its RevenueCat ID. ### rc_get_purchase Fetches details for a single one-time purchase, such as status and revenue. ### rc_get_subscription Gets the details of a specific subscription, including redemption info if available. ### rc_grant_entitlement Provides a customer with a promotional entitlement or trial until a specific time. ### rc_list_apps Returns a list of all apps configured in your RevenueCat project. ### rc_list_customers Searches for customers in your project using email or free-text queries. ### rc_list_discounts Lists all the discounts and promo offers defined in your project. ### rc_list_entitlements Shows all entitlements defined in the project, along with their products. ### rc_list_offerings Lists all offerings in the project, including their packages and products. ### rc_list_products Retrieves a list of products, which can be filtered by a specific app ID. ### rc_list_projects Lists all projects that your API key has access to. ### rc_refund_purchase Processes a refund for a one-time web-managed purchase. ### rc_refund_subscription Processes a refund for a web-managed subscription. ### rc_restore_purchase_by_order_id Restores a Google Play purchase to a customer using their order ID. ### rc_revoke_granted_entitlement Removes a promotional entitlement grant from a customer. ### rc_search_purchases Finds one-time purchases using a store-side identifier. ### rc_search_subscriptions Locates subscriptions using store-side identifiers like Apple transaction IDs. ### rc_set_customer_attributes Updates or deletes customer attributes like email or display name. ### rc_subscription_management_url Generates a signed URL that sends a customer to their store management page. ### rc_transfer_customer Moves a customer's purchases and subscriptions to a different customer ID. ### rc_assign_offering Applies an offering override to a customer or clears the current override. ## Prompt Examples **Prompt:** ``` Is the customer with email john@example.com still active on Pro? ``` **Response:** ``` Found one matching customer. Their entitlements show Pro is currently active and renews automatically. I can pull their full subscription record or grant an extension if you need. ``` **Prompt:** ``` Grant the pro entitlement to customer 19b8de26 for 14 days as a win-back. ``` **Response:** ``` Granted. The pro entitlement is now active for that customer for 14 days. Note that if they already hold a store purchase of pro, access continues from the store on its own terms. ``` **Prompt:** ``` Extend this web subscription by 14 days for customer satisfaction. ``` **Response:** ``` Extended the current billing period by 14 days with reason customer_satisfaction. The next charge is now pushed out by two weeks. ``` ## Capabilities ### Customer Intelligence Your agent can look up customer profiles and attributes using email or ID. ### Entitlement Management You can grant or revoke promotional access and trials through chat. ### Subscription Control The agent can extend, cancel, or refund web-managed subscriptions. ### Catalog Configuration You can manage entitlements, offerings, and product mappings. ### Support Automation Your agent can generate store management URLs to help customers manage their own plans. ## Use Cases ### Customer Support A user reports they aren't seeing their Pro features, so you check their entitlements and grant a trial to fix it immediately. ### Churn Recovery You identify a lapsed user and use the agent to grant a promotional entitlement to win them back. ### Billing Troubleshooting A customer asks for a refund on a web purchase, and you process it through the agent. ### Account Migration You move a user's existing purchases to a new account after they change their email address. ## Benefits - Eliminates the need to switch between support tools and the RevenueCat dashboard. - Enables rapid response to customer billing issues via natural language. - Centralizes subscription lifecycle management within your AI client. - Provides direct control over promotional grants and customer entitlements. ## How It Works Setting up the connection is fast, allowing you to start managing revenue data immediately. 1. Subscribe to the RevenueCat MCP on Vinkius. 2. Provide your V2 secret API key and project ID. 3. Connect your preferred MCP-compatible client like Claude or Cursor. 4. Ask your agent to perform actions using natural language. ## Frequently Asked Questions **Can I refund Apple or Google Play purchases through this MCP?** No. Apple and Google Play refunds must be handled through their respective stores or via a store management URL. This MCP only handles refunds for web-managed subscriptions. **How do I find a customer if I don't have their ID?** You can use the search tools to find customers by their email address or other free-text identifiers. **What happens if I grant an entitlement that a user already has via the App Store?** The promotional grant is applied, but the user's existing store-purchased access will continue to be managed by the store on its own terms. **Is it safe to use the transfer tool?** The transfer tool is a support operation. You should confirm the user's intent before running it, as the original customer will lose access to the transferred purchases. **How do I get my project ID?** You can use the list projects tool to see all projects visible to your API key and select the correct ID. **Which API key type do I need?** A **V2 secret key**. Create it in your project's Settings > API keys > + New, pick version V2 and the permissions you need. v1 keys do not work against the v2 API, so create a fresh v2 key if you only have v1 ones. **Do I need more than the API key?** Yes — the project ID too. It scopes every call. Find it in your dashboard URL (app.revenuecat.com/projects/) or call `rc_list_projects` to see which projects your key can see and copy the right one. **Can it cancel or refund an Apple or Google Play subscription?** Only for web-billing (RevenueCat-managed) subscriptions. For store plans, use `rc_subscription_management_url` to hand the customer a signed link to the store's own management flow, or the store API. Cancel/refund tools are explicitly limited to `rc_billing`.