Iaptic MCP Server

Iaptic MCP Server
官方

一个用于与 Iaptic API 交互的服务器,允许像 Claude 这样的人工智能模型查询客户、购买和交易数据,并检索统计见解。

客户数据平台
金融
TypeScript
访问服务器

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 服务器

smithery badge

一个用于与 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 MCP Server

通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。

官方
精选
本地
TypeScript
graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Playwright MCP Server

Playwright MCP Server

提供一个利用模型上下文协议的服务器,以实现类人浏览器的自动化,该服务器使用 Playwright,允许控制浏览器行为,例如导航、元素交互和滚动。

精选
本地
TypeScript
Apple MCP Server

Apple MCP Server

通过 MCP 协议与 Apple 应用(如“信息”、“备忘录”和“通讯录”)进行交互,从而使用自然语言发送消息、搜索和打开应用内容。

精选
本地
TypeScript
contentful-mcp

contentful-mcp

在你的 Contentful Space 中更新、创建、删除内容、内容模型和资源。

精选
TypeScript
serper-search-scrape-mcp-server

serper-search-scrape-mcp-server

这个 Serper MCP 服务器支持搜索和网页抓取,并且支持 Serper API 引入的所有最新参数,例如位置信息。

精选
TypeScript
The Verge News MCP Server

The Verge News MCP Server

提供从The Verge的RSS feed获取和搜索新闻的工具,允许用户获取今日新闻、检索过去一周的随机文章,以及在最近的Verge内容中搜索特定关键词。

精选
TypeScript
Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP Server

一个模型上下文协议 (MCP) 服务器,它使用 CoinCap API 提供全面的加密货币分析。该服务器通过一个易于使用的界面提供实时价格数据、市场分析和历史趋势。 (Alternative, slightly more formal and technical translation): 一个模型上下文协议 (MCP) 服务器,利用 CoinCap API 提供全面的加密货币分析服务。该服务器通过用户友好的界面,提供实时价格数据、市场分析以及历史趋势数据。

精选
TypeScript
MCP Server Trello

MCP Server Trello

通过 Trello API 促进与 Trello 看板的交互,提供速率限制、类型安全、输入验证和错误处理等功能,以实现对卡片、列表和看板活动的无缝管理。

精选
TypeScript
MCP DuckDB Knowledge Graph Memory Server

MCP DuckDB Knowledge Graph Memory Server

一个为 Claude 设计的记忆服务器,它使用 DuckDB 存储和检索知识图谱数据,从而增强了对话的性能和查询能力,并能持久保存用户信息。

精选
TypeScript