@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.
Installation
Claude Desktop
Installation Command
npx
Configuration
{ "iaptic": { "command": "npx", "args": [ "mcp-server-iaptic", "--api-key", "your-api-key-here", "--app-name", "your-app-name-here" ] } }
Instructions
Add to your Claude Desktop configuration file.
README
MCP Server for Iaptic
Permalink: MCP Server for 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.
Installation
Installing via Smithery
Permalink: Installing via Smithery
To install Iaptic for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-server-iaptic --client claude
Manual Installation
Permalink: Manual Installation
# 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
Permalink: Usage with Claude Desktop
Add to your Claude Desktop configuration file:
{
"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 customerscustomer_get
: Get customer details by ID
Purchases
-
purchase_list
: List purchaseslimit
: Maximum number of purchases to return (default: 100, max: 1000)offset
: Number of purchases to skip for paginationstartdate
: 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 filteringlimit
: Maximum number of transactions to return (default: 100, max: 1000)offset
: Number of transactions to skip for paginationstartdate
: 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 revenuestats_app
: Get app-specific statistics
Events
-
event_list
: List recent events with pagination and date filteringlimit
: Maximum number of events to return (default: 100)offset
: Number of events to skip for paginationstartdate
: 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 appappName
: Name of the app to switch toapiKey
: 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
# 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
About
Model Context Protocol server for interacting with iaptic