scroll-world
A skill that turn any brand into a scrollable 3D world landing page
OpenAI Ads MCP for ChatGPT Ads campaigns, creatives, audiences, insights, and conversions.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
A skill that turn any brand into a scrollable 3D world landing page
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 8/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 3/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 8/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 19/100 |
Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala OpenAI Ads MCP. Sigue https://mcp.popnx.com/i/trakkr-aisearch-openai-ads-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (openai-ads-mcp.trakkr.ai) · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude · unos 2 min
Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
CustomizeConnectors
Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue
OpenAI Ads MCPhttps://openai-ads-mcp.trakkr.ai/mcpPulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add
+ConnectorsOpenAI Ads MCP
Usa OpenAI Ads MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando OpenAI Ads MCP o muestra una herramienta de OpenAI Ads MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con ChatGPT según tu plan
MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web
Plugins+Add custom MCP server
Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin
OpenAI Ads MCPhttps://openai-ads-mcp.trakkr.ai/mcpAbre un chat nuevo y elige OpenAI Ads MCP en tus plugins antes de escribir
Usa OpenAI Ads MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si ChatGPT dice que está usando OpenAI Ads MCP o muestra una herramienta de OpenAI Ads MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Claude Code · unos 2 min
Sin clave y sin instalar nada
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --transport http --scope user openai-ads https://openai-ads-mcp.trakkr.ai/mcpDeberías ver OpenAI Ads MCP en la lista como conectado
Usa OpenAI Ads MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando OpenAI Ads MCP o muestra una herramienta de OpenAI Ads MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor · unos 2 min
Sin clave y sin instalar nada
Usa OpenAI Ads MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando OpenAI Ads MCP o muestra una herramienta de OpenAI Ads MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code · unos 2 min
Sin clave y sin instalar nada
Usa OpenAI Ads MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando OpenAI Ads MCP o muestra una herramienta de OpenAI Ads MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
Dirección para apps que se conectan por la web
https://openai-ads-mcp.trakkr.ai/mcpLa configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --transport http --scope user openai-ads https://openai-ads-mcp.trakkr.ai/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"openai-ads": {
"url": "https://openai-ads-mcp.trakkr.ai/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"openai-ads": {
"type": "http",
"url": "https://openai-ads-mcp.trakkr.ai/mcp"
}
}
}Claude Code
claude mcp add --scope user openai-ads --env OPENAI_ADS_API_KEY=your-value -- npx -y openai-ads-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"openai-ads": {
"command": "npx",
"args": [
"-y",
"openai-ads-mcp"
],
"env": {
"OPENAI_ADS_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"openai-ads": {
"command": "npx",
"args": [
"-y",
"openai-ads-mcp"
],
"env": {
"OPENAI_ADS_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"openai-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"openai-ads-mcp"
],
"env": {
"OPENAI_ADS_API_KEY": "your-value"
}
}
}
}OPENAI_ADS_API_KEY secreto obligatorio envOPENAI_ADS_MCP_READONLY envOPENAI_ADS_BUDGET_CEILING_USD envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: openai-ads-mcppypi: openai-ads-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se conectan por internet en
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.
get_accountGet the authenticated OpenAI Ads account. Use this first to verify that OPENAI_ADS_API_KEY works and to read account id, name, timezone, currency, and settings.
list_campaignsList campaigns in the authenticated ad account with cursor pagination.
get_campaignGet one campaign by id.
list_ad_groupsList ad groups for a campaign.
get_ad_groupGet one ad group by id.
list_adsList ads in an ad group.
get_adGet one ad by id, including review_status and creative metadata.
get_insightsGet performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.
list_audiencesList custom audiences for the authenticated ad account.
get_audienceGet one custom audience by id.
search_geoSearch geo targets for targeting.locations.include and return ids usable in campaign targeting.
manage_conversionsManage conversion pixels, API keys, event settings, and conversion reporting.
draft_context_hintsDraft deterministic context_hints for an ad group from product, audience, intent, and keywords.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub trakkr-aisearch, dueña del repo
Último cambio de código: hace 4 meses
Usa MIT
Respondió en 171 ms (HTTP 200)
No hace falta iniciar sesión
Leímos 13 descripciones de herramientas y no encontramos instrucciones ocultas para la IA
La dirección en la nube respondió 4 de las últimas 4 comprobaciones · última 171 ms · revisado 18 nov 2026
Sin entradas en OSV.dev para openai-ads-mcp@0.1.7
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/trakkr-aisearch-openai-ads-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: OPENAI_ADS_API_KEY
Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.
El repo de GitHub cambió por última vez hace 4 meses, y la última versión (0.1.7) llegó al registro hace 4 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).
En la misma categoría: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| Este OpenAI Ads MCP | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | En la nube o instalado en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | Sí | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Trakkr tracks the full AI-visibility funnel, organic and paid. This is the open-source paid-side companion.
openai-ads-mcp is a typed Model Context Protocol server for OpenAI Ads, ChatGPT Ads, and OpenAI's Advertiser API. It lets Claude, Cursor, Codex, VS Code, and other MCP clients inspect Ads accounts, read performance insights, build paused campaigns, upload creatives, manage audiences, and send conversion events.
People often search for this as a ChatGPT Ads MCP because the ads appear in ChatGPT. The package keeps the OpenAI Ads MCP name because ChatGPT Ads are managed through OpenAI Ads, Ads Manager, and the OpenAI Advertiser API.
Current public release: 0.1.7.
It ships in two runtimes with the same tool names, arguments, defaults, safety model, and vendored OpenAPI reference:
| Runtime | Best install | Package path |
|---|---|---|
| Python | uvx openai-ads-mcp | python/ |
| Node | npx -y openai-ads-mcp | typescript/ |
The goal is simple: make OpenAI Ads workable from an AI assistant without making spend easy to trigger by accident.
Python with uvx:
export OPENAI_ADS_API_KEY="..."
export OPENAI_ADS_MCP_READONLY=1 uvx openai-ads-mcp
Python with pip:
python -m pip install openai-ads-mcp
export OPENAI_ADS_API_KEY="..." export OPENAI_ADS_MCP_READONLY=1 openai-ads-mcp
Node with npx:
export OPENAI_ADS_API_KEY="..."
export OPENAI_ADS_MCP_READONLY=1 npx -y openai-ads-mcp
Node with npm:
npm install -g openai-ads-mcp
export OPENAI_ADS_API_KEY="..." export OPENAI_ADS_MCP_READONLY=1 openai-ads-mcp
For local development from this monorepo:
cd services/openai-ads-mcp/python
python -m pip install -e . python -m openai_ads_mcp
cd ../typescript npm install npm run build node dist/index.js
Create an Ads API key in OpenAI Ads Manager, then pass it as an environment variable.
export OPENAI_ADS_API_KEY="..."
Recommended first connection:
export OPENAI_ADS_MCP_READONLY=1
uvx openai-ads-mcp
Or with Node:
export OPENAI_ADS_MCP_READONLY=1
npx -y openai-ads-mcp
Readonly mode hides every write tool. They are absent from tools/list and cannot be called. Once you have confirmed the account and inspected data, unset OPENAI_ADS_MCP_READONLY to enable writes.
Optional environment variables:
| Variable | Purpose |
|---|---|
OPENAI_ADS_API_KEY | Required bearer key for https://api.ads.openai.com/v1. |
OPENAI_ADS_API_BASE_URL | Optional HTTPS override for tests or proxies. |
OPENAI_ADS_MCP_READONLY | Set to 1 or true to register read tools only. |
OPENAI_ADS_BUDGET_CEILING_USD | Optional budget guard. Default 100. |
This repo includes server.json for the official MCP Registry and downstream MCP directories. The canonical registry name is:
io.github.trakkr-aisearch/openai-ads-mcp
The Node package includes the matching mcpName, and the Python package README includes the matching mcp-name marker for PyPI ownership verification.
The registry metadata also advertises the hosted read-only Streamable HTTP endpoint:
https://openai-ads-mcp.trakkr.ai/mcp
That hosted endpoint is for discovery and read-only usage. It does not store or use a Trakkr-owned OpenAI Ads API key. The hosted endpoint allows anonymous initialize and tools/list; Ads API tool calls require the caller to send X-OpenAI-Ads-API-Key.
claude mcp add openai-ads \
-e OPENAI_ADS_API_KEY=your_ads_key_here \ -e OPENAI_ADS_MCP_READONLY=1 \ -- uvx openai-ads-mcp
claude mcp add openai-ads \
-e OPENAI_ADS_API_KEY=your_ads_key_here \ -e OPENAI_ADS_MCP_READONLY=1 \ -- npx -y openai-ads-mcp
{
"mcpServers": { "openai-ads": { "command": "uvx", "args": ["openai-ads-mcp"], "env": { "OPENAI_ADS_API_KEY": "your_ads_key_here", "OPENAI_ADS_MCP_READONLY": "1" } } } }
Use "command": "npx" and "args": ["-y", "openai-ads-mcp"] for the Node runtime.
[mcp_servers.openai_ads]
command = "uvx" args = ["openai-ads-mcp"] env = { OPENAI_ADS_API_KEY = "your_ads_key_here", OPENAI_ADS_MCP_READONLY = "1" }
Registry-compatible clients should discover this server by name:
io.github.trakkr-aisearch/openai-ads-mcp
The registry metadata lists npm, PyPI, and the hosted Streamable HTTP endpoint. The hosted endpoint does not require an API key for discovery, but it does require X-OpenAI-Ads-API-Key for Ads API tool calls.
The repository includes production Dockerfiles for hosted Streamable HTTP deployments:
docker build -t openai-ads-mcp .
docker run --rm -p 8080:8080 \ -e OPENAI_ADS_MCP_HOSTED_PUBLIC=1 \ -e OPENAI_ADS_MCP_TELEMETRY_SALT="local-test-salt" \ openai-ads-mcp
The narrower typescript/Dockerfile is used by the Cloud Run deploy script. For local stdio use, prefer uvx openai-ads-mcp or npx -y openai-ads-mcp.
The Node runtime can also serve MCP over Streamable HTTP for hosted or team deployments:
export OPENAI_ADS_MCP_HTTP_TOKEN="choose_a_long_random_token"
export OPENAI_ADS_MCP_READONLY=1 npx -y openai-ads-mcp --http
Defaults:
http://127.0.0.1:8080/mcp locally, or https://your-host/mcp behind a proxy.GET /healthz, GET /health, and GET /ready.OPENAI_ADS_MCP_READONLY=1 unless OPENAI_ADS_MCP_HTTP_ALLOW_WRITES=1 is set.OPENAI_ADS_MCP_HTTP_TOKEN protects the MCP endpoint with Authorization: Bearer .X-OpenAI-Ads-API-Key per request, or the server can use a server-side OPENAI_ADS_API_KEY.Useful hosted env vars:
| Variable | Purpose |
|---|---|
PORT or OPENAI_ADS_MCP_HTTP_PORT | HTTP port. Default 8080. |
OPENAI_ADS_MCP_HTTP_PATH | MCP path. Default /mcp. |
OPENAI_ADS_MCP_HEALTH_PATH | Health path. Default /healthz. |
OPENAI_ADS_MCP_HTTP_TOKEN | Optional bearer token required by hosted clients. |
OPENAI_ADS_MCP_HTTP_ALLOW_WRITES | Set to 1 only when you want write tools exposed over HTTP. |
OPENAI_ADS_MCP_HTTP_CORS_ORIGIN | Optional CORS origin. Default *. |
For public hosted endpoints, keep writes disabled and require users to bring their own Ads API key per request. Do not put a shared Ads API key in browser-visible config.
For a public discovery endpoint, use:
export OPENAI_ADS_MCP_HOSTED_PUBLIC=1
export OPENAI_ADS_MCP_TELEMETRY_SALT="long_random_value" npx -y openai-ads-mcp --http
Hosted public mode:
OPENAI_ADS_MCP_HTTP_ALLOW_WRITES=1OPENAI_ADS_API_KEY is presentX-OpenAI-Ads-API-Base-Urltools/listX-OpenAI-Ads-API-Key for Ads API tool callsThe production runbook is in HOSTED_DEPLOY.md.
The Python and Node runtimes expose the same 27 tools.
| Group | Tools |
|---|---|
| Account | get_account |
| Campaigns | list_campaigns, get_campaign, create_campaign, update_campaign, set_campaign_state |
| AdGroups | list_ad_groups, get_ad_group, create_ad_group, update_ad_group, set_ad_group_state |
| Ads | list_ads, get_ad, upload_creative, create_ad, update_ad, set_ad_state |
| Insights | get_insights |
| Audiences | list_audiences, get_audience, search_geo, manage_audience |
| Conversions | manage_conversions, send_conversions |
| Helpers | build_campaign, draft_context_hints, bulk_ab_test_hints |
| Tool | What it does |
|---|---|
get_account | Gets the ad account and confirms the API key works. |
get_insights | Reads account, campaign, ad group, or ad insights with fields, filters, sort, segments, and cursor pagination. |
create_campaign | Creates a paused campaign with a guarded lifetime budget, including conversion-optimized campaigns with one event setting. |
upload_creative | Uploads an image URL or local image file and returns file_id. |
create_ad | Creates a paused ad. chat_card requires target_url and file_id. |
build_campaign | Creates one paused campaign, one paused ad group, and paused ads in a guarded workflow. |
draft_context_hints | Deterministically drafts API-shaped context_hints with no hidden LLM call. |
send_conversions | Sends conversion events to https://bzr.openai.com/v1/events?pid=... after local validation, with optional validate_only. Supports obref and mobile app lifecycle events. |
get_insights accepts the current tagged time-range shape, for example:
{"type":"unix_range","start":1764547200,"end":1765152000}
The older nested shape is normalized for backward compatibility.
For conversion optimization, pass bidding_type="conversions" and exactly one conversion_event_setting_ids value to create_campaign. The campaign cannot use product-feed mode, and child ad groups must bill by click. build_campaign offers the same path through its singular conversion_event_setting_id helper argument. The bid is a CPA input even though OpenAI bills the child ad group per click.
OpenAI's Bulk API remains a limited preview and is not exposed as a general MCP tool. Product-feed campaign objects are supported, but feed connection and catalog upload still happen in Ads Manager or through OpenAI's supported SFTP flow.
This server can affect real ad spend, so the defaults are deliberately cautious.
build_campaign creates every object paused.set_campaign_state, set_ad_group_state, and set_ad_state.OPENAI_ADS_BUDGET_CEILING_USD, default 100.confirm_budget=True.OPENAI_ADS_MCP_READONLY=1 hides every write tool entirely.validate_only=true to validate a conversion batch without ingesting it.MCP annotations are set on every tool. Read tools use readOnlyHint. Write tools use readOnlyHint=false. Activation and budget-changing tools are marked destructive and open-world so hosts can prompt before running them.
First, connect safely:
export OPENAI_ADS_API_KEY="..."
export OPENAI_ADS_MCP_READONLY=1 uvx openai-ads-mcp
Ask your assistant:
Call get_account and list_campaigns. Confirm the Ads key works and show me what already exists.
Then restart without readonly mode and build a paused campaign:
Use draft_context_hints for "AI visibility monitoring software" aimed at growth teams with comparison intent.
Then call build_campaign with:
Do not activate anything.
Review the returned campaign, ad group, ads, budget, targeting, and review status. When you are ready to go live, activate each layer explicitly:
Call set_campaign_state with state="activate".
Call set_ad_group_state with state="activate". Call set_ad_state for the approved ad with state="activate".
Paid placements answer: where did you buy attention?
Trakkr answers: where does your brand show up orga