stackadapt-mcp

Ein MCP (Model Context Protocol)-Server zum Abfragen der StackAdapt-GraphQL-API. Ermöglicht KI-Assistenten wie Claude direkten Zugriff auf Ihre Kampagnendaten, Auslieferungsmetriken, Werbetreibende und mehr.

Tools

Related MCP server: GraphQL MCP Server

Einrichtung

API-Schlüssel abrufen

StackAdapt-API-Schlüssel unter: StackAdapt Platform → Settings → API.

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Fügen Sie dies zur .mcp.json Ihres Projekts hinzu:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "${STACKADAPT_API_KEY}"
      }
    }
  }
}

Setzen Sie dann die Umgebungsvariable in Ihrer Shell: export STACKADAPT_API_KEY=your-api-key-here

Datenhinweise

Ein paar Dinge, die Sie über die API von StackAdapt wissen sollten:

• cost, ecpc, ecpm, ecpe werden als Strings zurückgegeben – parsen Sie diese als Floats

• ctr ist bereits ein Prozentwert (0,214 bedeutet 0,214 %) – nicht mit 100 multiplizieren

• ecpe gibt für Zeiträume ohne Engagements "0" zurück

• Auslieferungs-Payloads sind GraphQL-UNION-Typen (Outcome | Progress) – große Abfragen können eine Progress-Antwort mit einer Job-ID zurückgeben; versuchen Sie es nach einigen Sekunden erneut

• Granularitätsoptionen: DAILY, WEEKLY, MONTHLY, TOTAL

Entwicklung

git clone https://github.com/aymanshaikh/stackadapt-mcp.git
cd stackadapt-mcp
npm install
npm run build

Um lokal zu testen, setzen Sie STACKADAPT_API_KEY und führen Sie Folgendes aus:

STACKADAPT_API_KEY=your-key node dist/index.js

Lizenz

MIT