MCP Server Iaptic

What iaptic/mcp-server-iaptic MCP server does

The iaptic/mcp-server-iaptic MCP server connects an MCP-compatible AI client to the Iaptic API. It provides tools for examining customer records, purchases, transactions, events, revenue statistics, and Stripe products and prices. The available operations include both list and detail lookups, along with a limited customer-data mutation for associating a purchase with a customer.

Customer tools can list customers, retrieve a customer by ID, check active subscription status, inspect a customer's transactions, and manually associate a purchase with that customer. Purchase and transaction tools support detail lookups as well as paginated lists. Event tools provide recent events and, for validator version 3.12 or later, event details with an option to include receipt validation information.

How it works

The server uses Iaptic API credentials configured at startup. The default connection targets one Iaptic app, while app-management tools expose the current app, reset the connection to its default app, or switch to another app by supplying an app name and API key.

List operations accept pagination parameters where documented. Purchases and transactions support date boundaries in ISO format, and purchases can be filtered by customer ID while transactions can be filtered by purchase ID. Event listing also supports date filters and can return raw JSON rather than formatted output.

Setup and configuration

Node.js 18 or newer and an Iaptic account with API credentials are required. The README documents running the server with npx mcp-server-iaptic and supplying --api-key and --app-name arguments. It also documents installing the package globally with npm, then starting it with the mcp-server-iaptic command.

For Claude Desktop, add an MCP entry whose command is npx and whose arguments identify the server package and the Iaptic API credentials. The repository also documents development commands for installing dependencies, running development mode, building, and starting the production build.

Tools and capabilities

The iaptic/mcp-server-iaptic MCP server exposes tools in these areas:

• Customers: list, retrieve, inspect subscriptions, inspect transactions, and associate purchases.
• Purchases: list with pagination and filters, or retrieve by ID. The documented maximum list size is 1,000.
• Transactions: list with pagination, date filters, and purchase filtering, or retrieve by ID.
• Statistics: retrieve general transaction and revenue statistics or app-specific statistics.
• Events: list recent events and retrieve event details, with optional receipt information.
• Stripe: list available products and prices.
• App management: inspect the active app, switch apps, or return to the default app.

Limitations and notes

The material does not specify Iaptic account pricing, rate limits, or the exact scope of permissions associated with the API key. Event-detail receipt validation is documented as available for validator 3.12 and later. The server requires credentials and an app name; it is not described as a credential-free local data source. Its license is MIT.