Iaptic

Model Context Protocol server for interacting with iaptic

typescript

5

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "iaptic-mcp-server-iaptic": {
      "command": "npx",
      "args": [
        "mcp-server-iaptic",
        "--api-key",
        "YOUR_API_KEY",
        "--app-name",
        "YOUR_APP_NAME"
      ]
    }
  }
}

You can run a Model Context Protocol (MCP) server to enable AIs like Claude to securely query and analyze your Iaptic data. This server exposes tools to access customers, purchases, transactions, statistics, events, and app management, helping you answer questions about your customers and business performance without exposing raw data.

How to use

Use the MCP server with your preferred MCP client by starting the server locally or connecting to a remote runtime. Once the server is running, your client will be able to call the exposed tools to list and retrieve data about customers, purchases, transactions, events, and statistics. Provide your API key when starting the server so the client can authenticate and access your Iaptic data.

How to install

Prerequisites you need before installing and running the MCP server:

Node.js version 18 or higher
An Iaptic account with API credentials

How to install

# Method 1: Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Method 2: Install globally and run
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

How to install

If you prefer to install via Smithery for automatic setup, you can use the Smithery CLI to install the MCP server for your client.

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

Available tools

customer_list

List customers available from the Iaptic dataset.

customer_get

Retrieve detailed information for a specific customer by ID.

purchase_list

List purchases with optional filters: limit, offset, startdate, enddate, and customerId.

purchase_get

Retrieve a specific purchase by its ID.

transaction_list

List transactions with pagination and date filtering; supports limit, offset, startdate, enddate, and purchaseId.

transaction_get

Retrieve a specific transaction by its ID.

stats_get

Get general statistics about transactions and revenue.

stats_app

Get statistics specific to an app.

event_list

List recent events with pagination and date filtering.

iaptic_switch_app

Switch to a different Iaptic app using appName and apiKey.

iaptic_reset_app

Reset to the default Iaptic app.

iaptic_current_app

Retrieve information about the currently active app.