Iaptic MCP Server

Iaptic MCP Server
Official

A server for interacting with the Iaptic API, allowing AI models like Claude to query customer, purchase, and transaction data, as well as retrieve statistical insights.

iaptic

Customer Data Platforms
Finance
TypeScript
Visit Server

Tools

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

README

MCP Server for Iaptic

smithery badge

A Model Context Protocol server for interacting with the Iaptic API. This server allows Claude or other AIs to interact with your Iaptic data to answer questions about your customers, purchases, transactions, and statistics.

Installation

Installing via Smithery

To install Iaptic for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-iaptic --client claude

Manual Installation

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Usage with Claude Desktop

Add to your Claude Desktop configuration file:

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

Available Tools

Customers

  • customer_list: List customers
  • customer_get: Get customer details by ID

Purchases

  • purchase_list: List purchases
    • limit: Maximum number of purchases to return (default: 100, max: 1000)
    • offset: Number of purchases to skip for pagination
    • startdate: Filter purchases after this date (ISO format, e.g. 2024-01-01)
    • enddate: Filter purchases before this date (ISO format, e.g. 2024-12-31)
    • customerId: Filter by customer ID
  • purchase_get: Get purchase details by ID

Transactions

  • transaction_list: List transactions with pagination and date filtering
    • limit: Maximum number of transactions to return (default: 100, max: 1000)
    • offset: Number of transactions to skip for pagination
    • startdate: Filter transactions after this date (ISO format, e.g. 2024-01-01)
    • enddate: Filter transactions before this date (ISO format, e.g. 2024-12-31)
    • purchaseId: Filter by purchase ID
  • transaction_get: Get transaction details by ID

Statistics

  • stats_get: Get general statistics about transactions and revenue
  • stats_app: Get app-specific statistics

Events

  • event_list: List recent events with pagination and date filtering
    • limit: Maximum number of events to return (default: 100)
    • offset: Number of events to skip for pagination
    • startdate: Filter events after this date (ISO format, e.g. 2024-01-01)
    • enddate: Filter events before this date (ISO format, e.g. 2024-12-31)

App Management

  • iaptic_switch_app: Switch to a different Iaptic app
    • appName: Name of the app to switch to
    • apiKey: API key for the app
  • iaptic_reset_app: Reset to the default Iaptic app
  • iaptic_current_app: Get information about the currently active app

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

Requirements

  • Node.js >= 18
  • An Iaptic account with API credentials

License

MIT

Recommended Servers

Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Playwright MCP Server

Playwright MCP Server

Provides a server utilizing Model Context Protocol to enable human-like browser automation with Playwright, allowing control over browser actions such as navigation, element interaction, and scrolling.

Featured
Local
TypeScript
Apple MCP Server

Apple MCP Server

Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.

Featured
Local
TypeScript
contentful-mcp

contentful-mcp

Update, create, delete content, content-models and assets in your Contentful Space

Featured
TypeScript
serper-search-scrape-mcp-server

serper-search-scrape-mcp-server

This Serper MCP Server supports search and webpage scraping, and all the most recent parameters introduced by the Serper API, like location.

Featured
TypeScript
The Verge News MCP Server

The Verge News MCP Server

Provides tools to fetch and search news from The Verge's RSS feed, allowing users to get today's news, retrieve random articles from the past week, and search for specific keywords in recent Verge content.

Featured
TypeScript
Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP Server

A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.

Featured
TypeScript
MCP Server Trello

MCP Server Trello

Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.

Featured
TypeScript
MCP DuckDB Knowledge Graph Memory Server

MCP DuckDB Knowledge Graph Memory Server

A memory server for Claude that stores and retrieves knowledge graph data in DuckDB, enhancing performance and query capabilities for conversations with persistent user information.

Featured
TypeScript