MCP Server Iaptic

🚀 Iaptic Model Context Protocol (MCP) Server

A Model Context Protocol server for interacting with the Iaptic API. This server enables Claude or other AIs to interact with your Iaptic data to answer questions about customers, purchases, transactions, and statistics.

🚀 Quick Start

The Iaptic Model Context Protocol (MCP) Server is designed to facilitate seamless interaction between AI models like Claude and your Iaptic data. With this server, you can easily query information about customers, purchases, transactions, and statistics.

✨ Features

• Data Interaction: Allows Claude or other AIs to interact with Iaptic data.
• Multiple Tools: Provides a variety of tools for querying customer, purchase, transaction, and statistical information.
• App Management: Supports switching between different Iaptic applications.

📦 Installation

Install via Smithery

Automatically install Iaptic through Smithery:

npx -y @smithery/cli install mcp-server-iaptic --client claude

Manual Installation

# Run directly
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

Use 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, maximum: 1000).
  • offset: Number of records to skip for pagination.
  • startdate: Filter records after the purchase date (ISO format, e.g., 2024-01-01).
  • enddate: Filter records before the purchase 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, maximum: 1000).
  • offset: Number of records to skip for pagination.
  • startdate: Filter records after the transaction date (ISO format, e.g., 2024-01-01).
  • enddate: Filter records before the transaction 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 on transactions and revenue.
• stats_app: Get application-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 records to skip for pagination.
  • startdate: Filter records after the event date (ISO format, e.g., 2024-01-01).
  • enddate: Filter records before the event date (ISO format, e.g., 2024-12-31).

App Management

• iaptic_switch_app: Switch to a different Iaptic application.
  • appName: Name of the application to switch to.
  • api-key: API key for the new application.
• iaptic_get_apps: Get all available Iaptic applications.

🔧 Technical Details

Development

npm install

npm run dev

Requirements

• Node.js: Minimum version 16.0.0
• You need a valid Iaptic account and API key