convez.ai
MCP ServerIntegração & APIsIntermediário
iaptic

MCP Server Iaptic

iaptic/mcp-server-iaptic

Integre dados Iaptic com Claude para análise de negócio

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor Model Context Protocol que conecta Claude diretamente à plataforma Iaptic para análise de clientes, compras, transações e estatísticas de receita. Permite queries em linguagem natural sobre dados de subscriptions e eventos de apps.

Instalação

$npx convez-ai iaptic/mcp-server-iaptic

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
10
Forks
6
Acompanhando
1
Saúde
50%
Último commit
há 4 dias
Versão
v1.2.1
Issues abertas
1
Contribuidores
2

Casos de uso

  • Consultar histórico de transações e compras de clientes
  • Gerar relatórios de receita e estatísticas de apps
  • Analisar status de subscriptions ativas
  • Validar eventos e recibos de compra via Stripe

Veredito

Integração sólida para monetização mobile/app. Ideal para founders que usam Iaptic e querem análise inteligente de dados de receita pelo Claude. Setup direto via Smithery, mas requer credenciais da API Iaptic.

README

A tradução para o português deste README ainda está na fila.

MCP Server for Iaptic

smithery badge

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

To install Iaptic for Claude Desktop automatically via Smithery:

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

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

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 customers with pagination
  • customer_get: Get detailed customer information by ID
  • customer_subscription: Get customer's active subscription status
  • customer_transactions: Get customer's transaction history
  • customer_add_purchase: Manually associate a purchase with a customer

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)
    • raw: Return raw JSON instead of formatted output (default: false)
  • event_details: Get detailed information about a specific event (validator 3.12+)
    • eventId: The event ID to get details for
    • receipts: Include receipt validation details (default: false)

Stripe

  • stripe_prices: Get available Stripe products and prices

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

# 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

Ver o original no GitHub

Bom para

Relacionados