Iaptic MCP Server Iaptic

🚀 Iaptic's MCP Server

A Model Context Protocol (MCP) server for interacting with the Iaptic API. This server enables Claude or other AI systems to answer questions about customers, purchases, transactions, and statistics using your Iaptic data.

🚀 Quick Start

This MCP server allows seamless interaction between AI systems and Iaptic data. Follow the steps below to get started.

📦 Installation

You can either run the server directly using npx or install it globally.

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

Using with Claude Desktop

Add the following content 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 customers
• customer_get: Get detailed customer information by ID

Purchases

• purchase_list: List purchase records
  • 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 detailed purchase information 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 detailed transaction information by ID

Statistics

• stats_get: Get general statistics about transactions and revenue
• stats_app: Get application-specific statistics

🔧 Technical Details

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run the production build
npm start

Requirements

• Node.js >= 18
• An Iaptic account with API credentials

📄 License

This project is licensed under the MIT license.