aipi-mcp

MCP server for Analytical Insider AIPI — 5-pillar AI visibility intelligence delivered as native Claude tools via the Model Context Protocol.

What it does

Exposes 5 MCP tools that call the AIPI A2A API:

| Tool | Route | Description | |------|-------|-------------| | aipi_capabilities | GET /api/v2/agents/capabilities | List all 6 intelligence agents | | aipi_analyze | POST /api/v2/intelligence/analyze | Full 5-pillar analysis | | aipi_analyze_pillar | POST /api/v2/intelligence/analyze/:pillar | Single-pillar (cheaper) | | aipi_probe | POST /api/v2/agents/probe | Probe an agent URL for trust tier | | aipi_get_report | GET /api/v2/intelligence/reports/:id | Retrieve a past report |

Pillars: GEO (AI citations across ChatGPT/Claude/Gemini/Perplexity), SEO (organic search), AIO (Google AI Overviews), AEO (answer engines), SXO (search experience).

Install

1. Get your API key

Contact [email protected] for a Bearer token tied to your org.

2. Add to Claude Desktop config

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "aipi": {
      "command": "npx",
      "args": ["-y", "aipi-mcp"],
      "env": {
        "AIPI_API_KEY": "YOUR_BEARER_TOKEN_HERE"
      }
    }
  }
}

3. Restart Claude Desktop

osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude

4. Verify

In any Claude Desktop conversation, ask:

"List AIPI agent capabilities"

You should see the 6 intelligence agents returned.

Usage examples

Full analysis:

"Run a full AIPI analysis on timeliner.io. Brand name is Timeliner, industry is video production software."

Single pillar (GEO — AI citation tracking):

"Run a GEO analysis on timeliner.io to see how often it's cited by ChatGPT, Claude, Gemini, and Perplexity."

Competitor benchmarking:

"Run a GEO analysis on timeliner.io with competitors frame.io and air.inc included."

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AIPI_API_KEY | Yes | — | Bearer token (org-scoped) | | AIPI_BASE_URL | No | https://agents.analyticalinsider.ai | Override for staging/dev |

Requirements

• Node.js >= 18
• Claude Desktop (or any MCP-compatible client)

Publishing

cd mcp
npm publish --access public

Published as the unscoped aipi-mcp package so any MCP client can install via npx -y aipi-mcp without org authentication.