OpenAI Ads MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/hypd-ai-openai-ads-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

11 read · 0 write · 0 deleteRead-only

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (11)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• get_account_insightsGet ad account insightsread-only

  Retrieve performance insights aggregated across the entire ad account. Returns a list response (`data[]` with `first_id`/`last_id`/`has_more` for paging). Each row carries `id`, `start_time`, `end_time`, plus the projected `fields` such as impressions, clicks, spend, ctr, cpc, cpm, readable_time, campaign_name, ad_group_name, and ad_name. Combine `aggregation_level`, `sort`, and `limit` to rank entities (e.g. the top ad by clicks). Monetary metrics (spend, cpc, cpm) are in the account's currency as decimal values, not micros.

• get_adGet adread-only

  Fetch a single ad by its ID, including its creative and review status.

• get_ad_accountGet ad accountread-only

  Fetch the ad account associated with the configured API key. Use this as a connectivity check to confirm the key is valid, and to read account-level details such as name, currency, status, and timezone. Each API key is scoped to a single ad account.

• get_ad_groupGet ad groupread-only

  Fetch a single ad group by its ID, including its status, bidding configuration, and context hints. Monetary values are expressed in micros: 1,000,000 micros = 1 unit of the account's currency (for example, $1.00 = 1,000,000 micros). Divide any *_micros value by 1,000,000 to show a human-readable amount, and multiply by 1,000,000 to convert a currency amount into micros.

• get_ad_group_insightsGet ad group insightsread-only

  Retrieve performance insights for a single ad group. Returns a list response (`data[]` with `first_id`/`last_id`/`has_more` for paging). Each row carries `id`, `start_time`, `end_time`, plus the projected `fields` such as impressions, clicks, spend, ctr, cpc, cpm, readable_time, campaign_name, ad_group_name, and ad_name. Combine `aggregation_level`, `sort`, and `limit` to rank entities (e.g. the top ad by clicks). Monetary metrics (spend, cpc, cpm) are in the account's currency as decimal values, not micros.

• get_ad_insightsGet ad insightsread-only

  Retrieve performance insights for a single ad. Returns a list response (`data[]` with `first_id`/`last_id`/`has_more` for paging). Each row carries `id`, `start_time`, `end_time`, plus the projected `fields` such as impressions, clicks, spend, ctr, cpc, cpm, readable_time, campaign_name, ad_group_name, and ad_name. Combine `aggregation_level`, `sort`, and `limit` to rank entities (e.g. the top ad by clicks). Monetary metrics (spend, cpc, cpm) are in the account's currency as decimal values, not micros.

• get_campaignGet campaignread-only

  Fetch a single campaign by its ID, including its objective, status, budget, and targeting. Monetary values are expressed in micros: 1,000,000 micros = 1 unit of the account's currency (for example, $1.00 = 1,000,000 micros). Divide any *_micros value by 1,000,000 to show a human-readable amount, and multiply by 1,000,000 to convert a currency amount into micros.

• get_campaign_insightsGet campaign insightsread-only

  Retrieve performance insights for a single campaign. Returns a list response (`data[]` with `first_id`/`last_id`/`has_more` for paging). Each row carries `id`, `start_time`, `end_time`, plus the projected `fields` such as impressions, clicks, spend, ctr, cpc, cpm, readable_time, campaign_name, ad_group_name, and ad_name. Combine `aggregation_level`, `sort`, and `limit` to rank entities (e.g. the top ad by clicks). Monetary metrics (spend, cpc, cpm) are in the account's currency as decimal values, not micros.

• list_ad_groupsList ad groupsread-only

  List ad groups within a campaign (`campaign_id` is required). Ad groups belong to a campaign and hold the bidding configuration and context hints. Supports cursor pagination (`order`, `after`/`before`; the response includes `first_id`, `last_id`, and `has_more`). Monetary values are expressed in micros: 1,000,000 micros = 1 unit of the account's currency (for example, $1.00 = 1,000,000 micros). Divide any *_micros value by 1,000,000 to show a human-readable amount, and multiply by 1,000,000 to convert a currency amount into micros.

• list_adsList adsread-only

  List ads within an ad group (`ad_group_id` is required). Each ad holds a creative (title, body, target URL, image) and a `review_status` (in_review, approved, or rejected). Supports cursor pagination (`order`, `after`/`before`; the response includes `first_id`, `last_id`, and `has_more`).

• list_campaignsList campaignsread-only

  List campaigns in the ad account. Campaigns are the top-level objects that define the objective, budget, and country targeting. Supports cursor pagination; the response includes `first_id`, `last_id`, and `has_more`. Monetary values are expressed in micros: 1,000,000 micros = 1 unit of the account's currency (for example, $1.00 = 1,000,000 micros). Divide any *_micros value by 1,000,000 to show a human-readable amount, and multiply by 1,000,000 to convert a currency amount into micros.

Signals

Stars

5

Forks

1

Open issues

0

Weekly downloads

36

Last commit

Jun 3, 2026 (4 months ago)

Last release

Jun 3, 2026 (4 months ago)

Last package publish

Jun 3, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.HYPD-AI/openai-ads-mcp

Version

0.1.3

Auth

API key

Packages

npm @hypd-ai/openai-ads-mcp

License

MIT

Repository

github.com/HYPD-AI/openai-ads-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql