MCP Server for Iaptic

1# MCP Server for Iaptic
2[![smithery badge](https://smithery.ai/badge/mcp-server-iaptic)](https://smithery.ai/server/mcp-server-iaptic)
3 
4A Model Context Protocol server for interacting with the [Iaptic API](https://www.iaptic.com). This server allows Claude or other AIs to interact with your Iaptic data to answer questions about your customers, purchases, transactions, and statistics.
5 
6## Installation
7 
8### Installing via Smithery
9 
10To install Iaptic for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-server-iaptic):
11 
12```bash
13npx -y @smithery/cli install mcp-server-iaptic --client claude
14```
15 
16### Manual Installation
17```bash
18# Run directly with npx
19npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME
20 
21# Or install globally
22npm install -g mcp-server-iaptic
23mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME
24```
25 
26## Usage with Claude Desktop
27 
28Add to your Claude Desktop configuration file:
29 
30```json
31{
32  "iaptic": {
33    "command": "npx",
34    "args": [
35      "mcp-server-iaptic",
36      "--api-key", "your-api-key-here",
37      "--app-name", "your-app-name-here"
38    ]
39  }
40}
41```
42 
43## Available Tools
44 
45### Customers
46- `customer_list`: List customers
47- `customer_get`: Get customer details by ID
48 
49### Purchases
50- `purchase_list`: List purchases
51  - `limit`: Maximum number of purchases to return (default: 100, max: 1000)
52  - `offset`: Number of purchases to skip for pagination
53  - `startdate`: Filter purchases after this date (ISO format, e.g. 2024-01-01)
54  - `enddate`: Filter purchases before this date (ISO format, e.g. 2024-12-31)
55  - `customerId`: Filter by customer ID
56- `purchase_get`: Get purchase details by ID
57 
58### Transactions
59- `transaction_list`: List transactions with pagination and date filtering
60  - `limit`: Maximum number of transactions to return (default: 100, max: 1000)
61  - `offset`: Number of transactions to skip for pagination
62  - `startdate`: Filter transactions after this date (ISO format, e.g. 2024-01-01)
63  - `enddate`: Filter transactions before this date (ISO format, e.g. 2024-12-31)
64  - `purchaseId`: Filter by purchase ID
65- `transaction_get`: Get transaction details by ID
66 
67### Statistics
68- `stats_get`: Get general statistics about transactions and revenue
69- `stats_app`: Get app-specific statistics
70 
71### Events
72- `event_list`: List recent events with pagination and date filtering
73  - `limit`: Maximum number of events to return (default: 100)
74  - `offset`: Number of events to skip for pagination
75  - `startdate`: Filter events after this date (ISO format, e.g. 2024-01-01)
76  - `enddate`: Filter events before this date (ISO format, e.g. 2024-12-31)
77 
78### App Management
79- `iaptic_switch_app`: Switch to a different Iaptic app
80  - `appName`: Name of the app to switch to
81  - `apiKey`: API key for the app
82- `iaptic_reset_app`: Reset to the default Iaptic app
83- `iaptic_current_app`: Get information about the currently active app
84 
85## Development
86 
87```bash
88# Install dependencies
89npm install
90 
91# Run in development mode
92npm run dev
93 
94# Build for production
95npm run build
96 
97# Run production build
98npm start
99```
100 
101## Requirements
102 
103- Node.js >= 18
104- An Iaptic account with API credentials
105 
106## License
107 
108MIT 
109