Iaptic MCP ServerOfficial
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
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
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 customerscustomer_get
: Get customer details by ID
Purchases
purchase_list
: List purchaseslimit
: Maximum number of purchases to return (default: 100, max: 1000)offset
: Number of purchases to skip for paginationstartdate
: 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 filteringlimit
: Maximum number of transactions to return (default: 100, max: 1000)offset
: Number of transactions to skip for paginationstartdate
: 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 revenuestats_app
: Get app-specific statistics
Events
event_list
: List recent events with pagination and date filteringlimit
: Maximum number of events to return (default: 100)offset
: Number of events to skip for paginationstartdate
: 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 appappName
: Name of the app to switch toapiKey
: API key for the app
iaptic_reset_app
: Reset to the default Iaptic appiaptic_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
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.
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.
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.
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.
contentful-mcp
Update, create, delete content, content-models and assets in your Contentful Space
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.
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.
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.
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.
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.