简介

一个用于与Iaptic API交互的服务器，允许像Claude这样的AI模型查询客户、购买和交易数据，以及获取统计洞察。

简介

一个用于与Iaptic API交互的服务器，允许像Claude这样的AI模型查询客户、购买和交易数据，以及获取统计洞察。

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

工具列表

• 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

来源

• 来源：github
• 链接：https://github.com/iaptic/mcp-server-iaptic