Iaptic MCP Server官方
一个用于与 Iaptic API 交互的服务器,允许像 Claude 这样的人工智能模型查询客户、购买和交易数据,并检索统计见解。
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
用于 Iaptic 的 MCP 服务器
一个用于与 Iaptic API 交互的模型上下文协议服务器。该服务器允许 Claude 或其他 AI 与您的 Iaptic 数据交互,以回答有关您的客户、购买、交易和统计信息的问题。
安装
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Iaptic:
npx -y @smithery/cli install mcp-server-iaptic --client claude
手动安装
# 使用 npx 直接运行
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME
# 或者全局安装
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
: 获取有关当前活动应用的信息
开发
# 安装依赖
npm install
# 在开发模式下运行
npm run dev
# 构建用于生产
npm run build
# 运行生产构建
npm start
要求
- Node.js >= 18
- 具有 API 凭据的 Iaptic 帐户
许可证
MIT
推荐服务器
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Playwright MCP Server
提供一个利用模型上下文协议的服务器,以实现类人浏览器的自动化,该服务器使用 Playwright,允许控制浏览器行为,例如导航、元素交互和滚动。
Apple MCP Server
通过 MCP 协议与 Apple 应用(如“信息”、“备忘录”和“通讯录”)进行交互,从而使用自然语言发送消息、搜索和打开应用内容。
contentful-mcp
在你的 Contentful Space 中更新、创建、删除内容、内容模型和资源。
serper-search-scrape-mcp-server
这个 Serper MCP 服务器支持搜索和网页抓取,并且支持 Serper API 引入的所有最新参数,例如位置信息。
The Verge News MCP Server
提供从The Verge的RSS feed获取和搜索新闻的工具,允许用户获取今日新闻、检索过去一周的随机文章,以及在最近的Verge内容中搜索特定关键词。
Crypto Price & Market Analysis MCP Server
一个模型上下文协议 (MCP) 服务器,它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器,利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面,提供实时价格数据、市场分析以及历史趋势数据。
MCP Server Trello
通过 Trello API 促进与 Trello 看板的交互,提供速率限制、类型安全、输入验证和错误处理等功能,以实现对卡片、列表和看板活动的无缝管理。
MCP DuckDB Knowledge Graph Memory Server
一个为 Claude 设计的记忆服务器,它使用 DuckDB 存储和检索知识图谱数据,从而增强了对话的性能和查询能力,并能持久保存用户信息。