gravity-ads-mcp

Servidor MCP local para la API del panel de anunciantes de Gravity. Crea, edita, pausa y archiva campañas — y obtén todos tus informes — desde cualquier agente compatible con MCP sin que tu clave API salga de tu máquina.

Gravity ofrece un servidor MCP alojado en https://platform.trygravity.ai/mcp, pero es de solo lectura. Este paquete envuelve la API completa del panel de Gravity (incluyendo crear/editar) como un servidor MCP local stdio que se ejecuta mediante npx, de modo que las solicitudes van directamente desde tu ordenador a platform.trygravity.ai — nada pasa por un tercero.

Requisitos previos

• Node.js ≥ 18 (node --version para comprobar)

• npx (incluido con npm; viene con Node)

• Una clave API de anunciante de Gravity — obtén la tuya en https://app.trygravity.ai en Configuración → Clave API

Related MCP server: Google Ads MCP Worker

Inicio rápido

Añade lo siguiente al archivo de configuración de tu cliente MCP. Sustituye your-gravity-api-key por tu clave real.

Claude Desktop

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

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Usuarios de Windows: Si no se encuentra npx, prueba con "command": "cmd" y "args": ["/c", "npx", "-y", "gravity-ads-mcp"].

Claude Code

Crea un archivo .mcp.json en la raíz de tu proyecto (o añádelo a ~/.claude/mcp.json para configuración global):

{
  "mcpServers": {
    "gravity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

O añádelo mediante CLI:

claude mcp add gravity --env GRAVITY_API_KEY=your-gravity-api-key -- npx -y gravity-ads-mcp

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

opencode

opencode.json en la raíz de tu proyecto:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gravity": {
      "type": "local",
      "command": ["npx", "-y", "gravity-ads-mcp"],
      "environment": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Nota: opencode usa "environment" (no "env").

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Otros clientes

Cualquier cliente MCP que admita el formato JSON mcpServers (misma forma que Claude Desktop) puede usar este servidor. Añade lo siguiente al archivo de configuración MCP de tu cliente:

{
  "mcpServers": {
    "gravity": {
      "command": "npx",
      "args": ["-y", "gravity-ads-mcp"],
      "env": {
        "GRAVITY_API_KEY": "your-gravity-api-key"
      }
    }
  }
}

Variables de entorno

Herramientas

Cuenta

Campañas

Grupos de anuncios y anuncios

Informes

Ejemplos de prompts

Una vez configurado, prueba a pedirle a tu agente:

• "Lista mis campañas activas"

• "¿Cuál es mi ROAS de los últimos 14 días?"

• "Crea una campaña llamada 'Summer Sale' con un presupuesto de $100/día, dirigida a EE. UU. y CA, usando un grupo de anuncios generativo para zapatillas de correr"

• "Pausa todas las campañas con más de $500 de gasto"

• "Muéstrame el rendimiento del grupo de anuncios para la campaña camp-456 de los últimos 7 días en America/New_York"

• "Crea un grupo de anuncios manual con estos anuncios: titular '50% Off Running Shoes', texto 'Summer sale on all running shoes.', CTA 'Shop Now'"

• "¿Qué conversiones obtuve ayer?"

• "Crea un píxel para https://acme.com"

Seguridad y privacidad

• Tu GRAVITY_API_KEY se pasa como variable de entorno del proceso y nunca se registra ni se transmite a ningún servidor que no sea platform.trygravity.ai.

• Todas las solicitudes API van directamente desde tu máquina a la API de Gravity — sin intermediarios.

• Ejecutar mediante npx significa que no hay instalación global; el servidor se inicia fresco en cada sesión.

• Regenera tu clave en cualquier momento en https://app.trygravity.ai en Configuración → Clave API.

Solución de problemas

Colaboradores

Para instrucciones de configuración local, compilación, pruebas y publicación, consulta DEVELOPMENT.md.

Licencia

MIT