andi-mcp-client

MCP (Model Context Protocol) stdio adapter for connecting Claude, Cursor, and other AI clients to the Andi Analytics MCP server.

Quick Start

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "andi": {
      "command": "npx",
      "args": ["-y", "andi-mcp-client"]
    }
  }
}

For Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "andi": {
      "command": "npx",
      "args": ["-y", "andi-mcp-client"]
    }
  }
}

Custom Server URL

To connect to a different Andi MCP server:

{
  "mcpServers": {
    "andi": {
      "command": "npx",
      "args": ["-y", "andi-mcp-client"],
      "env": {
        "MCP_SERVER_URL": "https://your-server.example.com"
      }
    }
  }
}

Available Tools

Once connected, you'll have access to these analytics tools:

| Tool | Description | |------|-------------| | sales_traffic_api | Revenue, orders, sessions, and conversion metrics | | advertising_api | Ad campaigns, spend, ACOS, and ROI data | | keyword_api | Search term performance and rankings | | inventory_api | Stock levels, aging, and storage costs | | financial_api | Costs, revenue, refunds, and margins | | voc_performance_api | Reviews, ratings, and customer feedback | | content_api | Product listings and content compliance | | competitive_performance_api | Competitor analysis and market positioning |

How It Works

┌─────────────┐     stdio      ┌─────────────┐     HTTPS     ┌─────────────┐
│   Claude    │ ──────────────▶│   This      │ ──────────────▶│   Andi MCP  │
│   Cursor    │◀──────────────│   Adapter   │◀──────────────│   Server    │
└─────────────┘    (local)     └─────────────┘    (remote)    └─────────────┘

The adapter:

1. Receives JSON-RPC requests from your AI client via stdin
2. Forwards them to the remote Andi MCP server via HTTPS
3. Returns responses via stdout

This gives you the reliability of local stdio communication while connecting to a remote server.

Requirements

• Node.js 16 or higher
• Internet connection to reach the MCP server

License

MIT