iaptic/mcp-server-iaptic

A Model Context Protocol server for interacting with the Iaptic API. This server allows Claude or other AIs to interact with your Iaptic data to answer questions about your customers, purchases, transactions, and statistics.
Scope
The server is read-only with respect to your Iaptic data: tools can query customers, purchases, transactions, events and statistics, but cannot modify records, issue refunds, or change your Iaptic configuration. Three groups of tools operate outside stored data: stripe_checkout / stripe_portal are the only tools that create anything — Stripe checkout or billing-portal sessions (links your customer uses to pay or manage their subscription), never Iaptic records; stripe_purchases looks up a customer's purchases by checkout-session access token; and iaptic_switch_app / iaptic_reset_app change which app's credentials are used for subsequent queries.
Installation
Installing via Smithery
To install Iaptic for Claude Desktop automatically via Smithery:
Manual Installation
Usage with Claude Desktop
Add to your Claude Desktop configuration file:
Available Tools
Customers
- 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
Purchases
- 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
Transactions
- transaction_list: List transactions with pagination and date filtering
- limit: Maximum number of transactions to return (default: 100, max: 1000)
- offset: Number of transactions to skip for pagination
- startdate: Filter transactions after this date (ISO format, e.g. 2024-01-01)
- enddate: Filter transactions before this date (ISO format, e.g. 2024-12-31)
- purchaseId: Filter by purchase ID
- transaction_get: Get transaction details by ID
Statistics
- stats_get: Get general statistics about transactions and revenue
- stats_app: Get app-specific statistics
Events
- event_list: List recent events with pagination and date filtering
- limit: Maximum number of events to return (default: 100)
- offset: Number of events to skip for pagination
- startdate: Filter events after this date (ISO format, e.g. 2024-01-01)
- enddate: Filter events before this date (ISO format, e.g. 2024-12-31)
- 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)