stackadapt-mcp

Un servidor MCP (Model Context Protocol) para consultar la API GraphQL de StackAdapt. Proporciona a asistentes de IA como Claude acceso directo a los datos de tus campañas, métricas de entrega, anunciantes y más.

Herramientas

Related MCP server: GraphQL MCP Server

Configuración

Obtén tu clave de API

Clave de API de StackAdapt desde: Plataforma StackAdapt → Configuración → API.

Claude Desktop

Añade a tu claude_desktop_config.json:

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

Claude Code

Añade al archivo .mcp.json de tu proyecto:

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

Luego, establece la variable de entorno en tu terminal: export STACKADAPT_API_KEY=tu-clave-de-api-aqui

Notas sobre los datos

Algunas cosas que debes saber sobre la API de StackAdapt:

• cost, ecpc, ecpm, ecpe se devuelven como cadenas: analízalos como números de punto flotante (floats)

• ctr ya es un valor porcentual (0.214 significa 0.214%): no lo multipliques por 100

• ecpe devuelve "0" para períodos con cero interacciones

• Las cargas útiles de entrega son tipos UNION de GraphQL (Outcome | Progress): las consultas grandes pueden devolver una respuesta Progress con un ID de trabajo; vuelve a intentarlo después de unos segundos

• Opciones de granularidad: DAILY, WEEKLY, MONTHLY, TOTAL

Desarrollo

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

Para probar localmente, establece STACKADAPT_API_KEY y ejecuta:

STACKADAPT_API_KEY=your-key node dist/index.js

Licencia

MIT