Servidor MCP

OpenAI Ads MCP

io.github.trakkr-aisearch/openai-ads-mcp
Marketing y publicidad Público y accesible MCP 2026-07-28

Qué hace este MCP

Manages OpenAI Ads campaigns, ad groups, ads, audiences, geo targeting, conversion settings, and performance insights.

draft_context_hints
Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['product'], 'properties': {'intent': {'type': 'string'}, 'product': {'type': 'string'}, 'audience': {'type': 'string'}, 'keywords': {}}, 'additionalProperties': False}
get_account
Get 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.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
get_ad
Get one ad by id, including review_status and creative metadata.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ad_id'], 'properties': {'ad_id': {'type': 'string'}}, 'additionalProperties': False}
get_ad_group
Get one ad group by id.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ad_group_id'], 'properties': {'ad_group_id': {'type': 'string'}}, 'additionalProperties': False}
get_audience
Get one custom audience by id.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['audience_id'], 'properties': {'audience_id': {'type': 'string'}}, 'additionalProperties': False}
get_campaign
Get one campaign by id.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string'}}, 'additionalProperties': False}
get_insights
Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['scope'], 'properties': {'sort': {}, 'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'scope': {'enum': ['account', 'campaign', 'ad_group', 'ad'], 'type': 'string'}, 'before': {'type': 'string'}, 'fields': {}, 'filters': {}, 'includes': {}, 'segments': {}, 'entity_id': {'type': 'string'}, 'time_range': {}, 'response_format': {'enum': ['concise', 'detailed'], 'type': 'string', 'default': 'concise'}, 'time_granularity': {'enum': ['hourly', 'daily', 'monthly', 'none'], 'type': 'string', 'default': 'daily'}, 'aggregation_level': {'enum': ['ad_account', 'campaign', 'ad_group', 'ad'], 'type': 'string'}, 'override_segment_group_order': {}}, 'additionalProperties': False}
list_ad_groups
List ad groups for a campaign.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaign_id'], 'properties': {'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc'}, 'before': {'type': 'string'}, 'campaign_id': {'type': 'string'}}, 'additionalProperties': False}
list_ads
List ads in an ad group.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ad_group_id'], 'properties': {'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc'}, 'before': {'type': 'string'}, 'ad_group_id': {'type': 'string'}}, 'additionalProperties': False}
list_audiences
List custom audiences for the authenticated ad account.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc'}, 'before': {'type': 'string'}}, 'additionalProperties': False}
list_campaigns
List campaigns in the authenticated ad account with cursor pagination.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc'}, 'before': {'type': 'string'}}, 'additionalProperties': False}
manage_conversions
Manage conversion pixels, API keys, event settings, and conversion reporting.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'name': {'type': 'string'}, 'after': {'type': 'string'}, 'limit': {'type': 'integer', 'default': 20}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'default': 'desc'}, 'action': {'enum': ['create_pixel', 'create_api_key', 'get_event_settings', 'set_event_settings', 'get_insights'], 'type': 'string'}, 'before': {'type': 'string'}, 'entity_ids': {}, 'event_type': {'type': 'string'}, 'source_ids': {}, 'client_type': {'enum': ['web'], 'type': 'string', 'default': 'web'}, 'time_ranges': {}, 'aggregation_level': {'type': 'string'}, 'custom_event_name': {'type': 'string'}, 'attribution_window_days': {'type': 'integer'}}, 'additionalProperties': False}
search_geo
Search geo targets for targeting.locations.include and return ids usable in campaign targeting.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string'}}, 'additionalProperties': False}
Añadido
draft_context_hints
17 de September de 2026 a las 12:52
Añadido
manage_conversions
17 de September de 2026 a las 12:52
Añadido
search_geo
17 de September de 2026 a las 12:52
Añadido
get_audience
17 de September de 2026 a las 12:52
Añadido
list_audiences
17 de September de 2026 a las 12:52
Añadido
get_insights
17 de September de 2026 a las 12:52
Añadido
get_ad
17 de September de 2026 a las 12:52
Añadido
list_ads
17 de September de 2026 a las 12:52
Añadido
get_ad_group
17 de September de 2026 a las 12:52
Añadido
list_ad_groups
17 de September de 2026 a las 12:52
Añadido
get_campaign
17 de September de 2026 a las 12:52
Añadido
list_campaigns
17 de September de 2026 a las 12:52
Añadido
get_account
17 de September de 2026 a las 12:52