vexqo Get an API key

Connect Claude Code, Codex or Cursor to Meta's Ad Library

Connect vexqo's MCP server to your coding agent and ask what any brand runs on Meta: its offers, its messages and when they ran. Setup is one command or one small file.

One question, answered from the library

We asked Claude Code what Gymshark ran in the UK for Black Friday last year. It made two tool calls and answered in about half a minute.

Claude Code, with the vexqo MCP serverRecorded 20 November 2026
You

What did Gymshark run on Meta in the UK for Black Friday last year? Tell me the offers and the angles.

Claude

I'll start by finding Gymshark's page ID.

Tool
search_meta_adsq: "Gymshark" · country: "GB" · active_status: "all" · limit: 55 of 41,681 ads · 4.5 s · 1 credit
Claude

Page ID is 129669023798560. Now I'll pull its ads that started around Black Friday 2025.

Tool
search_meta_adspage_id: "129669023798560" · country: "GB" · active_status: "all" · start_date: "2025-11-01" · end_date: "2025-12-02" · limit: 3030 of 991 ads · 3.2 s · 3 credits
Claude

Gymshark's UK Black Friday 2025 ads on Meta ran from 18 November to about 3 December. The offer stepped up in stages.

  • 18 NovBlack Friday Sale, up to 50% off everythingExtra 10% with WELCOME10, shown in some ads
  • 21 to 24 NovSame sale, up to 50% offNew-customer ads used NEW15 for an extra 15%
  • 22 Nov"Time for heavy gifting": up to 50% off, plus free returns extended to 31 Jan 2026
  • 27 to 28 NovUp to 50% off, plus an extra 25% off everythingEXTRA25
  • 30 Nov"Ends soon" last-chance push: up to 50% off, plus an extra 25%Code (the ad text cuts off before naming it)

The sample leaves out lower-impression ads. There may be other offers or codes in the remaining ~960 ads.

2 tool calls4 credits31.5 s from question to answer

A real session in Claude Code 2.1.322 with Claude Sonnet 5.5, recorded on 20 November 2026. The seconds are the ones each call took. The answer is shortened.

What it found: Gymshark's Black Friday approach

All 30 ads offered up to 50% off. What changed was the extra code on top, which grew as Black Friday came closer, and the message around it.

Each agent put it in its own words. Claude Code: "The offer stepped up in stages." Cursor: "a stacked discount ladder, not a single offer". Codex: "up to 50% off, boosted by NEW15 early in the week and EXTRA25 for Black Friday weekend/payday".

This reading comes from 30 of the 991 ads that ran in that period, the ones with the most impressions. The library does not show spend or sales, so it tells you what Gymshark ran and not what worked. Black Friday 2026 is on 27 November: ask the same question about your own competitors.

Why this question is a fair test

Set it up

Pick your agent. Each one needs two things: the server's address, https://api.vexqo.dev/mcp, and your API key.

Your connection

Claude Code

MCP · HTTP

One command adds the server for every project on your machine.

  1. Get an API key. The trial is free and has 500 credits.
  2. Run the command below in a terminal, with your key in place of YOUR_KEY.
  3. Start Claude Code and type /mcp. vexqo should show five tools.
Terminal
claude mcp add --transport http --scope user vexqo https://api.vexqo.dev/mcp \
  --header "X-API-Key: YOUR_KEY"

To share the server with one project, put this file at its root and set VEXQO_API_KEY in your shell. The key stays out of the file.

.mcp.json
{
  "mcpServers": {
    "vexqo": {
      "type": "http",
      "url": "https://api.vexqo.dev/mcp",
      "headers": {
        "X-API-Key": "${VEXQO_API_KEY}"
      }
    }
  }
}
Download

Claude Code MCP documentation

Your connection

Codex

MCP · HTTP

Codex reads the key from an environment variable, so it never sits in the configuration.

  1. Get an API key. The trial is free and has 500 credits.
  2. Run the two lines below in a terminal, with your key in place of YOUR_KEY. Add the first line to your shell profile so it lasts.
  3. Start Codex and ask your question. It lists vexqo among its MCP servers.
Terminal
export VEXQO_API_KEY="YOUR_KEY"
codex mcp add vexqo --url https://api.vexqo.dev/mcp \
  --bearer-token-env-var VEXQO_API_KEY

The second line writes this to ~/.codex/config.toml. You can add it by hand.

config.toml
[mcp_servers.vexqo]
url = "https://api.vexqo.dev/mcp"
bearer_token_env_var = "VEXQO_API_KEY"

Codex MCP documentation

Your connection

Cursor

MCP · HTTP

Open the install dialog with one click, or add the configuration by hand.

  1. Get an API key. The trial is free and has 500 credits.
  2. Choose Add to Cursor and put your key in place of YOUR_KEY in the dialog. Or put the configuration below in ~/.cursor/mcp.json.
  3. Open the MCP page of Cursor's settings. vexqo should show five tools. Approve the first call when the chat asks.
Add to Cursor
mcp.json
{
  "mcpServers": {
    "vexqo": {
      "url": "https://api.vexqo.dev/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}
Download

Cursor's command-line agent refuses a tool call nobody approved. Allow these with "Mcp(vexqo:*)" in the permissions of .cursor/cli.json.

Cursor MCP documentation

The five tools your agent gets

A tool call costs the same credits as the API request behind it, and every answer says what it cost.

ToolWhat it returnsCredits
search_meta_adsUp to 30 ads for a keyword or an advertiser, with the library's total and a cursor for more1 for every 10 ads
get_meta_adOne ad whole: its full text, every card, its media links and the details panel2
search_ebay_listingsOne page of eBay results for a keyword1 for every 15 results
get_ebay_listingOne eBay listing: price, condition, seller, shipping and item specifics4
get_accountThe credits left, the limits, the prices and the usage of the last 30 daysFree

Questions to try first

What did Gymshark run on Meta in the UK for Black Friday last year? Tell me the offers and the angles.

Which ads did Sephora start in the US this week? Group them by angle.

Search Meta ads for "running shoes" in Germany and list the ten advertisers that appear most.

All three answered it

We asked each agent the Gymshark question on 20 November 2026. The time depends on how much the agent decides to read.

AgentWhat it readTime
Claude Code 2.1.3222 searches31.5 s
Cursor, command-line agent2 searches and 5 whole ads202 s
Codex 0.166.017 searches and 9 whole ads571 s

What to know before you rely on it

Ask about your own competitors

The trial is free and has 500 credits. The session above cost 4.

Get an API key