iaptic数据平台
一个用于与Iaptic API交互的服务器，允许像Claude这样的AI模型查询客户、购买和交易数据，以及获取统计洞察。
可用工具 （16 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
customer_list 2 个参数
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 1 个参数 需填 1 项
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
必填参数：customerId
customer_add_purchase 2 个参数 需填 2 项
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
必填参数：customerId、purchaseId
customer_subscription 1 个参数 需填 1 项
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
必填参数：customerId
customer_transactions 1 个参数 需填 1 项
Get customer's transaction history. - Returns list of all transactions - Includes: - Payment details - Transaction status - Associated purchases - Timestamps
必填参数：customerId
purchase_list 5 个参数
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 1 个参数 需填 1 项
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
必填参数：purchaseId
transaction_list 5 个参数
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 1 个参数 需填 1 项
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
必填参数：transactionId
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 4 个参数
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 2 个参数 需填 1 项
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)
必填参数：appName
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
该工具无需必填参数，直接调用即可
服务介绍
MCP Server for Iaptic
一个用于与Iaptic API交互的模型上下文协议服务器。此服务器允许Claude或其他AI与您的Iaptic数据进行交互，以回答有关您的客户、购买、交易和统计数据的问题。
安装
通过Smithery安装
要通过Smithery自动为Claude Desktop安装Iaptic：
npx -y @smithery/cli install mcp-server-iaptic --client claude
手动安装
# 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
与Claude Desktop一起使用
在您的Claude Desktop配置文件中添加：
{
"iaptic": {
"command": "npx",
"args": [
"mcp-server-iaptic",
"--api-key", "your-api-key-here",
"--app-name", "your-app-name-here"
]
}
}
可用工具
客户
customer_list: 列出客户customer_get: 根据ID获取客户详情
购买
purchase_list: 列出购买记录limit: 返回的最大购买数量（默认：100，最大：1000）offset: 分页时跳过的购买数量startdate: 过滤在此日期之后的购买记录（ISO格式，例如2024-01-01）enddate: 过滤在此日期之前的购买记录（ISO格式，例如2024-12-31）customerId: 按客户ID过滤
purchase_get: 根据ID获取购买详情
交易
transaction_list: 列出带有分页和日期过滤的交易limit: 返回的最大交易数量（默认：100，最大：1000）offset: 分页时跳过的交易数量startdate: 过滤在此日期之后的交易（ISO格式，例如2024-01-01）enddate: 过滤在此日期之前的交易（ISO格式，例如2024-12-31）purchaseId: 按购买ID过滤
transaction_get: 根据ID获取交易详情
统计
stats_get: 获取关于交易和收入的一般统计信息stats_app: 获取应用程序特定的统计信息
事件
event_list: 列出带有分页和日期过滤的最近事件limit: 返回的最大事件数量（默认：100）offset: 分页时跳过的事件数量startdate: 过滤在此日期之后的事件（ISO格式，例如2024-01-01）enddate: 过滤在此日期之前的事件（ISO格式，例如2024-12-31）
应用程序管理
iaptic_switch_app: 切换到不同的Iaptic应用appName: 要切换的应用名称apiKey: 应用的API密钥
iaptic_reset_app: 重置为默认的Iaptic应用iaptic_current_app: 获取当前活动应用的信息
开发
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run production build
npm start
要求
- Node.js >= 18
- 具有API凭证的Iaptic账户
许可证
MIT
