# iaptic/mcp-server-iaptic [Health: Active]

**Category:** 👤 Customer Data Platforms  
**Repository:** https://github.com/iaptic/mcp-server-iaptic  
**GitHub Stars:** 9  
**npm Downloads (last month):** 72  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/iaptic-mcp-server-iaptic

## Description
Connect with iaptic to ask about your Customer Purchases, Transaction data and App Revenue statistics.

## Tools
Capabilities this server exposes over MCP:

- **customer_list** — List customers with pagination
- **customer_get** — Get detailed customer information by ID
- **customer_subscription** — Get customer's active subscription status
- **customer_transactions** — Get customer's transaction history
- **customer_add_purchase** — Manually associate a purchase with a customer
- **purchase_list** — List purchases
- **limit** — Maximum number of purchases to return (default: 100, max: 1000)
- **offset** — Number of purchases to skip for pagination
- **startdate** — Filter purchases after this date (ISO format, e.g. 2024-01-01)
- **enddate** — Filter purchases before this date (ISO format, e.g. 2024-12-31)
- **customerId** — Filter by customer ID
- **purchase_get** — Get purchase details by ID
- **transaction_list** — List transactions with pagination and date filtering
- **purchaseId** — Filter by purchase ID
- **transaction_get** — Get transaction details by ID
- **stats_get** — Get general statistics about transactions and revenue
- **stats_app** — Get app-specific statistics
- **event_list** — List recent events with pagination and date filtering
- **raw** — Return raw JSON instead of formatted output (default: false)
- **event_details** — Get detailed information about a specific event (validator 3.12+)
- **eventId** — The event ID to get details for
- **receipts** — Include receipt validation details (default: false)
- **stripe_prices** — Get available Stripe products and prices
- **iaptic_switch_app** — Switch to a different Iaptic app
- **appName** — Name of the app to switch to
- **apiKey** — API key for the app
- **iaptic_reset_app** — Reset to the default Iaptic app
- **iaptic_current_app** — Get information about the currently active app

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server-iaptic": {
    "command": "npx",
    "args": ["-y","@smithery/cli"]
  }
}
```

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/iaptic-mcp-server-iaptic/readme_