Iaptic MCP Server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
IAPTIC_API_KEYYesYour API key for accessing the Iaptic server.
IAPTIC_APP_NAMEYesYour application name for the Iaptic server.

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
customer_list

List customers from your Iaptic account.

  • Returns a paginated list of customers with their purchase status
  • Each customer includes:
    • Application username
    • Last purchase information
    • Subscription status (active/lapsed)
    • Renewal intent
    • Trial/introductory period status
  • Use limit and offset for pagination (default: 100 customers per page)
  • Results are ordered by creation date (newest first)
customer_get

Get detailed information about a specific customer.

  • Returns complete customer profile including:
    • Application username
    • Purchase history
    • Active and expired subscriptions
    • Last purchase details
    • Subscription renewal status
    • Trial and introductory period information
  • Required: customerId parameter
customer_add_purchase

Manually associate a customer with a purchase.

  • Links a purchase to a specific customer
  • Takes priority over receipt validation links
  • Useful for manual purchase management
  • Purchase format should be "platform:purchaseId", for example apple:123109519983
  • Required: customerId and purchaseId
customer_subscription

Get customer's subscription status.

  • Returns active subscription details if any
  • Includes:
    • Subscription status and expiry
    • Payment and renewal information
    • Trial/introductory period status
  • Simpler alternative to customer_get for subscription-only apps
customer_transactions

Get customer's transaction history.

  • Returns list of all transactions
  • Includes:
    • Payment details
    • Transaction status
    • Associated purchases
    • Timestamps
purchase_list

List purchases from your Iaptic account.

  • Returns a paginated list of purchases
  • Use limit and offset for pagination (default: 100 per page)
  • Filter by date range using startdate and enddate (ISO format)
  • Filter by customerId to see purchases from a specific customer
  • Results include purchase status, product info, and transaction details
  • Results are ordered by purchase date (newest first)
purchase_get

Get detailed information about a specific purchase.

  • Returns complete purchase details including:
    • Product information
    • Purchase status
    • Associated transactions
    • Customer information
    • Subscription details (if applicable)
  • Required: purchaseId parameter
transaction_list

List financial transactions from your Iaptic account.

  • Returns a paginated list of transactions
  • Use limit and offset for pagination (default: 100 per page)
  • Filter by date range using startdate and enddate (ISO format)
  • Filter by purchaseId to see transactions for a specific purchase
  • Results include transaction status, amount, currency, and payment details
  • Results are ordered by transaction date (newest first)
  • Important: Use date filtering to avoid retrieving too many records
transaction_get

Get detailed information about a specific transaction.

  • Returns complete transaction details including:
    • Transaction status
    • Amount and currency
    • Payment method details
    • Associated purchase information
    • Customer information
    • Timestamps and audit data
  • Required: transactionId parameter
stats_get

Get general transactions, revenue and usage statistics from your Iaptic account.

  • Returns aggregated metrics including:
    • Total revenue
    • Number of active subscriptions
    • Customer growth metrics
    • Transaction success rates
    • Revenue by product type
  • Data is aggregated across all your applications
stats_app

Get statistics specific to your application.

  • Returns app-specific metrics including:
    • App revenue and growth
    • Active subscriptions for this app
    • Customer metrics for this app
    • Product performance statistics
    • Transaction metrics
  • Uses the app name provided during server initialization
stripe_prices

Get available Stripe products and prices.

  • Returns list of products with their associated prices
  • Each product includes:
    • Product ID and display name
    • Description and metadata
    • Available pricing offers
    • Subscription terms if applicable
  • Results are cached for 5 minutes
event_list

List recent events from your Iaptic account.

  • Returns a paginated list of system events
  • Events include:
    • Receipt validations
    • Platform notifications (Apple/Google/etc)
    • Webhook deliveries
    • Purchase status changes
    • Subscription renewals
  • Use limit and offset for pagination
  • Results ordered by date (newest first)
iaptic_switch_app

Switch to a different Iaptic app.

  • Allows temporarily using a different app's credentials
  • All subsequent API calls will use the new app name and API key
  • If using a master key, only the app name needs to be changed
  • Useful for managing multiple apps in the same session
  • Required: appName parameter (apiKey required only if not using master key)
iaptic_reset_app

Reset to the default Iaptic app.

  • Reverts to the original app credentials provided during server initialization
  • All subsequent API calls will use the default app name and API key
  • Use this after using iaptic_switch_app to return to the default app
iaptic_current_app

Get information about the currently active Iaptic app.

  • Returns the current app name
  • Indicates whether using default or custom credentials
  • Shows if using a master key for authentication