_ registry / mcp http-sse · checked 2h ago

OpenAI Ads

https://openai-ads-mcp.trakkr.ai

Registry code: 8e3272fa35cfc796

api record

Typed MCP tools for OpenAI's Advertiser API. Use get_account first to confirm the API key works, then read insights before changing spend. The safest workflow is: check the account, inspect campaigns and insights, build new campaigns paused, review the created campaign, ad group, and ads, then activate each layer explicitly when the user asks.

Safety model:

endpoint
https://openai-ads-mcp.trakkr.ai/mcp
protocol
http-sse ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is OpenAI Ads live?
Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.
Is OpenAI Ads free to use?
Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.
What tools does OpenAI Ads have?
13 tools: draft_context_hints, search_geo, manage_conversions, get_ad_group, get_account, get_campaign, list_campaigns, get_audience, ….
Is OpenAI Ads safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
261ms

last good check

priced tools
0

of 13 tools

_ answered our checks, 90 days 373 checks · signed record
  • unknown → live
_ what it is for
used for
  • list ad campaigns
  • get ad performance insights
  • manage conversion tracking
  • search geo targets for ads
  • draft ad group context hints
takes → gives
text → data
tools
12 reads1 effect unclear
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 13 tools
12 auth-required 1 never probed 12 of 13 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • search_geo reads auth-required 2h ago

    Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "query"
      ],
      "properties": {
        "query": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • manage_conversions auth-required 6h ago

    Manage conversion pixels, API keys, event settings, and conversion reporting.

    mcp-tool

    {
      "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
    }
    arguments 63 lines
  • get_ad_group reads auth-required 6h ago

    Get one ad group by id.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "ad_group_id"
      ],
      "properties": {
        "ad_group_id": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • get_account reads auth-required 17h ago

    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.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {},
      "additionalProperties": false
    }
    arguments 6 lines
  • get_campaign reads auth-required 13h ago

    Get one campaign by id.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "campaign_id"
      ],
      "properties": {
        "campaign_id": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • list_campaigns reads auth-required 17h ago

    List campaigns in the authenticated ad account with cursor pagination.

    mcp-tool

    {
      "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
    }
    arguments 25 lines
  • get_audience reads auth-required 6h ago

    Get one custom audience by id.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "audience_id"
      ],
      "properties": {
        "audience_id": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • get_insights reads auth-required 13h ago

    Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

    mcp-tool

    {
      "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
    }
    arguments 66 lines
  • list_ad_groups reads auth-required 13h ago

    List ad groups for a campaign.

    mcp-tool

    {
      "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
    }
    arguments 31 lines
  • get_ad reads auth-required 9h ago

    Get one ad by id, including review_status and creative metadata.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "ad_id"
      ],
      "properties": {
        "ad_id": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • list_ads reads auth-required 9h ago

    List ads in an ad group.

    mcp-tool

    {
      "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
    }
    arguments 31 lines
  • list_audiences reads auth-required 17h ago

    List custom audiences for the authenticated ad account.

    mcp-tool

    {
      "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
    }
    arguments 25 lines
  • draft_context_hints reads unknown 9h ago

    Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

    mcp-tool

    {
      "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
    }
    arguments 20 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 8e3272fa35cfc796.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/8e3272fa35cfc796/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/8e3272fa35cfc796/badge.svg)](https://brick.blue/agent/8e3272fa35cfc796?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on trakkr.ai 1 entry

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.