https://github.com/iaptic/mcp-server-iaptic
Model Context Protocol server for interacting with iaptic
https://github.com/iaptic/mcp-server-iaptic
Last synced: 25 days ago
JSON representation
Model Context Protocol server for interacting with iaptic
- Host: GitHub
- URL: https://github.com/iaptic/mcp-server-iaptic
- Owner: iaptic
- License: mit
- Created: 2025-01-16T21:41:08.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T16:31:46.000Z (about 2 months ago)
- Last Synced: 2025-02-26T17:25:19.692Z (about 2 months ago)
- Language: TypeScript
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-list - @iaptic/mcp-server-iaptic - server-iaptic?style=social)](https://github.com/iaptic/mcp-server-iaptic): Connects to iaptic to retrieve customer purchase and app revenue data. (Uncategorized / Uncategorized)
- awesome-mcp-servers - @iaptic/mcp-server-iaptic - Connect with [iaptic](https://www.iaptic.com) to ask about your Customer Purchases, Transaction data and App Revenue statistics. (Legend / 👤 <a name="customer-data-platforms"></a>Customer Data Platforms)
- awesome-mcp-servers - @iaptic/mcp-server-iaptic - Connect with [iaptic](https://www.iaptic.com) to ask about your Customer Purchases, Transaction data and App Revenue statistics. (Legend / 👤 <a name="customer-data-platforms"></a>Customer Data Platforms)
- awesome-mcp-servers - Iaptic MCP Server - Model Context Protocol server for interacting with iaptic (Table of Contents / Other Tools and Integrations)
README
# MCP Server for Iaptic
[](https://smithery.ai/server/mcp-server-iaptic)
A 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.
## Installation
### Installing via Smithery
To install Iaptic for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-server-iaptic):
```bash
npx -y @smithery/cli install mcp-server-iaptic --client claude
```
### Manual Installation
```bash
# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME
# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME
```
## Usage with Claude Desktop
Add to your Claude Desktop configuration file:
```json
{
"iaptic": {
"command": "npx",
"args": [
"mcp-server-iaptic",
"--api-key", "your-api-key-here",
"--app-name", "your-app-name-here"
]
}
}
```
## Available Tools
### Customers
- `customer_list`: List customers
- `customer_get`: Get customer details by ID
### 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)
### App Management
- `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
## Development
```bash
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Run production build
npm start
```
## Requirements
- Node.js >= 18
- An Iaptic account with API credentials
## License
MIT