How to Use the Criteo Marketing API MCP in Windsurf

Q: How do I connect the Criteo Marketing API to Windsurf?

Open your mcpconfig.json file in Windsurf and add this MCP Server under the mcpServers key with your Vinkius credentials. Cascade will automatically read the available tools and let you start querying your ad data right away. It takes about two minutes to set up.

Let Windsurf autonomously run, track, and tweak your Criteo campaigns without you ever leaving Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Criteo Marketing API MCP to Windsurf

Create your Vinkius account to connect Criteo Marketing API to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Criteo Marketing API with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let this MCP Server manage your Criteo budgets

The `list_marketing_budgets` tool lets Windsurf check your active spend directly inside your workspace. You shouldn't have to jump between browser tabs just to check if your retargeting campaigns are burning cash. If a budget runs low, Cascade can flag it instantly. It doesn't stop at just looking up numbers. The agent can chain this with `list_marketing_campaigns` to trace exactly which campaigns are eating up your daily limits. You get immediate visibility without opening the Criteo dashboard once.

Analyze ad set performance on the fly

The `get_marketing_statistics` tool pulls raw performance data and compiles it right in your editor. Stop guessing which creative works and which one flops. Cascade reads these stats, spots the trends, and tells you exactly which ad set is winning. When you need to dive deeper, Cascade runs `get_ad_set_details` to inspect the exact configuration of your targeting groups. It matches performance spikes to specific settings, giving you clear answers on why your ads are converting.

Audit your audiences and creatives

The `list_audiences` tool maps out your entire targeting strategy in one go, pulling direct data via this MCP Server. Keeping track of who sees your ads gets messy fast. You see exactly who you are targeting without digging through nested web menus. Once the audience is clear, the agent uses `list_ad_creatives` to verify which banners or videos are assigned to those groups. It links your assets to your targets so you know your messaging matches your market.

Setup guide

Set up Criteo Marketing API MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Criteo Marketing API MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Criteo Marketing API payment history." If connected, Cascade will call the Criteo Marketing API tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "criteo-marketing-api-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Criteo Marketing. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Criteo Marketing API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Criteo Marketing API MCP in Windsurf

Open your `mcp_config.json` file in Windsurf and add this MCP Server under the `mcpServers` key with your Vinkius credentials. Cascade will automatically read the available tools and let you start querying your ad data right away. It takes about two minutes to set up.

Yes, Cascade can chain multiple tools back-to-back to build a full report. It starts by running `list_marketing_campaigns` to grab active IDs, then pulls metrics with `get_marketing_statistics`. You get a complete markdown report written directly into your workspace.

Cascade excels at this by running sequential tool calls without needing a prompt for each step. For example, it can list your advertisers using `list_advertisers` and immediately pull ad set details via `list_ad_sets` for whichever account you specify. You just tell it the end goal.

This integration gives Cascade access to ten distinct tools for managing your growth engine. It can inspect campaigns with `get_campaign_details`, check budgets, and list ad creatives. You have complete control over your marketing setup from the sidebar.

Vinkius runs this server inside an isolated V8 sandbox, meaning your private marketing statistics and budget limits are never exposed or stored. All API calls are direct and ephemeral. Your credentials remain locked down on your local machine.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript