Back to Documentation

MCP Server

Connect AI tools like Claude, Cursor, and Codex to manage your store

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants interact with external tools. The revnu MCP server exposes 47 tools across 12 modules, giving your AI assistant full access to manage your store, products, licenses, analytics, coupons, affiliates, and more.

Prerequisites

You need an API key from your revnu dashboard:

  1. 1. Go to Dashboard → CLI
  2. 2. Your API key is displayed under API Keys & MCP
  3. 3. Copy the key (or use the one-click install buttons)

Setup

Cursor

Click Add to Cursor in your dashboard CLI page — it opens a deeplink that configures everything automatically.

Or add manually to .cursor/mcp.json:

{
  "mcpServers": {
    "revnu": {
      "type": "streamable-http",
      "url": "https://revnu.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Run this command in your terminal:

claude mcp add --transport http revnu https://revnu.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Add this to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "revnu": {
      "type": "streamable-http",
      "url": "https://revnu.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex

export REVNU_API_KEY="YOUR_API_KEY"
codex mcp add revnu --url https://revnu.app/api/mcp \
  --bearer-token-env-var REVNU_API_KEY

Configuration

All editors use the same configuration structure:

Transport: streamable-http

Endpoint: https://revnu.app/api/mcp

Authentication: Bearer token via Authorization header

Tool Reference

47 tools across 12 modules. Each tool is callable from any MCP-compatible AI assistant.

Store (4 tools)

get_contextGet full onboarding context including store, products, connections, and next steps
create_storeCreate a new store with name, subdomain, and optional settings
update_storeUpdate store name, description, currency, or product types
set_product_typesSet available product types (discord, license_key, web_app)

Products (5 tools)

list_productsList all products, optionally filtered by status
create_productCreate a product with name, price, billing interval, and features
get_productGet a single product by ID
update_productUpdate product name, description, price, or settings
delete_productDelete a product

Licenses (4 tools)

list_licensesList license keys, optionally filtered by status
get_licenseGet license key details including device activations
revoke_licenseRevoke a license key
reactivate_licenseReactivate a revoked license key

Coupons (6 tools)

list_couponsList coupons, optionally filtered by status
create_couponCreate a coupon with code, discount type, duration, and scope
update_couponUpdate coupon redemption limits, expiry, or scope
delete_couponDelete a coupon
activate_couponActivate a paused coupon
pause_couponPause an active coupon

Analytics (3 tools)

get_kpisGet key performance indicators (revenue, customers, MRR, churn)
get_recent_purchasesGet recent purchases with optional limit
get_revenueGet revenue timeseries data with optional date range

Purchases (2 tools)

list_purchasesList purchases with optional status, date range, and limit filters
get_purchaseGet details of a specific purchase

Affiliates (6 tools)

list_affiliatesList affiliates, optionally filtered by status
create_affiliateInvite a new affiliate by email and name
update_affiliateUpdate an affiliate's name or email
delete_affiliateRemove an affiliate
get_affiliate_settingsGet affiliate program settings
update_affiliate_settingsUpdate commission rates, cookie expiry, payout minimums

A/B Tests (7 tools)

list_abtestsList all A/B tests
create_abtestCreate a test with variants, weights, duration, and goal
delete_abtestDelete a test
start_abtestStart a draft test
pause_abtestPause a running test
stop_abtestStop a test and determine winner
get_abtest_resultsGet test results with conversion data

Publishing (3 tools)

publish_storePublish store and mark onboarding complete
setup_hostingTrigger subdomain provisioning for your store
get_hosting_statusPoll hosting/deployment status

Stripe (2 tools)

get_stripe_connect_urlGet Stripe Connect onboarding URL
get_stripe_statusPoll Stripe connection status

Discord (2 tools)

get_discord_auth_urlGet Discord OAuth URLs for account and bot setup
get_discord_statusPoll Discord connection status

Assets (3 tools)

upload_logoUpload a logo or banner from a URL
generate_landing_pageStart AI landing page generation with a vibe description
get_landing_page_statusPoll landing page generation progress

Example Usage

Once connected, use natural language with your AI assistant:

"What's my store's revenue this month?"

"Create a product called Pro Plan for $29/month"

"List all active license keys"

"Create a 20% off coupon code LAUNCH20"

"Show me my A/B test results"

"Invite john@example.com as an affiliate"