stackadapt-mcp

Сервер MCP (Model Context Protocol) для выполнения запросов к GraphQL API StackAdapt. Предоставляет ИИ-ассистентам, таким как Claude, прямой доступ к данным ваших кампаний, метрикам доставки, рекламодателям и многому другому.

Инструменты

Related MCP server: GraphQL MCP Server

Настройка

Получение API-ключа

API-ключ StackAdapt можно найти здесь: Платформа StackAdapt → Настройки → API.

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

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

Claude Code

Добавьте в файл .mcp.json вашего проекта:

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

Затем установите переменную окружения в вашей оболочке: export STACKADAPT_API_KEY=ваш-api-ключ-здесь

Примечания к данным

Несколько важных моментов об API StackAdapt:

• cost, ecpc, ecpm, ecpe возвращаются в виде строк — преобразуйте их в числа с плавающей точкой (float)

• ctr уже является процентным значением (0.214 означает 0.214%) — не умножайте на 100

• ecpe возвращает "0" для периодов с нулевым количеством взаимодействий

• Полезные нагрузки доставки (Delivery payloads) являются типами GraphQL UNION (Outcome | Progress) — большие запросы могут вернуть ответ Progress с идентификатором задания (job ID); повторите запрос через несколько секунд

• Варианты детализации (Granularity): DAILY, WEEKLY, MONTHLY, TOTAL

Разработка

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

Для локального тестирования установите STACKADAPT_API_KEY и выполните:

STACKADAPT_API_KEY=your-key node dist/index.js

Лицензия

MIT