Connect your AI

Use StealAds from Claude, ChatGPT, Cursor, Codex and other AI tools. Ask for competitor ads, winning ads and the longest-running ads in plain words, then adapt a winning ad for your brand.

Choose your connection

Where you use StealAds	How you connect	What it can do
Claude directory	One click from Claude’s Connectors directory, once listed. No link to paste.	Research happens in Claude. “Make it in StealAds” opens the app to make the ad. No ad making inside the chat.
Claude or ChatGPT custom connector	Paste the full connection link, then sign in to StealAds. No API key needed.	Everything, including making ads in the chat after you approve the cost. Galleries show where the app supports them.
Claude Code, Codex, Cursor, Gemini CLI	Add the same full connection link using the instructions below, then sign in. No API key needed.	Everything, including making ads after approval. Results include readable lists with image and ad links.
Scripts and automation	Use the stealads-agent CLI with an API key from Settings → Agent API Keys.	CLI access to brands, campaigns and research, within the key’s permissions.

The full connection link

Use this address for a Claude or ChatGPT custom connector and every coding agent below. Sign in with StealAds. No API key needed.

https://mcp.stealads.ai/mcp

Want to know what you can ask for? See every MCP tool.

Chat apps

For the Claude directory version, connect in one click from Claude’s Connectors directory once StealAds is listed. It does research in Claude and opens StealAds to make the ad.

Claude custom connector

Open Connectors and add a custom connector named StealAds. Paste the full link, choose automatic registration, then sign in.

ChatGPT custom connector

Enable Developer Mode where your plan and workspace allow it, then create a custom app with the full link. Choose OAuth and sign in. Select StealAds in your conversation.

Coding agent setup

Claude Code

Run this command, then open /mcp in Claude Code and authenticate StealAds in your browser.

claude mcp add --transport http stealads https://mcp.stealads.ai/mcp

Claude Code setup docs

Codex

Run both commands, then complete the browser sign-in.

codex mcp add stealads --url https://mcp.stealads.ai/mcp
codex mcp login stealads

Codex setup docs

Cursor

Merge this entry into .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects. Open MCP settings and connect StealAds to sign in.

{
  "mcpServers": {
    "stealads": {
      "url": "https://mcp.stealads.ai/mcp"
    }
  }
}

Cursor setup docs

Gemini CLI

Run this command, then open Gemini CLI and run /mcp auth stealads to sign in.

gemini mcp add --transport http stealads https://mcp.stealads.ai/mcp

Gemini CLI setup docs

Scripts

Create a scoped API key in StealAds Settings → Agent API Keys. Use the stealads-agent CLI to sign in and check access before running automation. Keep API keys out of source code and chat messages.

stealads-agent auth login --api-key <your-api-key>
stealads-agent --json doctor

What the tools do

Search public Facebook and Instagram ads by advertiser or topic, inspect individual ads, compare hooks and run lengths, and read your brand profiles and saved research. The tools available depend on the connection you use and the permissions you approve.

The Claude directory connection does research in Claude. “Make it in StealAds” opens the app to make the ad. A Claude or ChatGPT custom connector uses the full connection link and can make ads in the chat after you approve the cost.

What Facebook ads can StealAds find for Gymshark?
Find the longest-running ads in the meal kit category.
Find winning ads in skincare.
Make me an ad like this one for Northwind Coffee.

Authentication and permissions

StealAds uses OAuth: you sign in on the StealAds authorization page rather than pasting your password or an API key into chat. Read permission allows searching and viewing account data. Write permission allows supported changes such as saving research. Spend permission allows tools that consume credits. Only approve permissions you intend to use.

Your connected AI receives the tool results it requests, which can include brand information, saved research and ad content. Review the StealAds privacy policy at https://stealads.ai/privacy and your AI provider’s privacy settings before connecting.

Library rules

The shared library is search-only. Each request returns a capped sample of matching ads, not a complete inventory. Tracked-rival pages return at most 50 ads per page. When a tool provides a cursor, it can request another capped page.

There is no bulk export, library total, or coverage count. An empty result does not prove an advertiser has no ads. Run length is evidence of longevity, not proof of sales or ad performance. StealAds does not manage your Meta ad account.

Plans and credits

A StealAds account is required. Your StealAds plan and balance determine which actions are available; your Claude or ChatGPT subscription is separate. Connecting does not purchase a plan or add credits.

Making an ad and some research or tracking actions use StealAds credits. Check the action’s cost and your balance before approving it. Manage your plan and credits in the StealAds app.

Disconnect or get help

Disconnect StealAds in your AI tool’s connector or app settings, and revoke its authorization in StealAds Settings to stop further access. Disconnecting does not delete research already returned to a conversation.

If connecting fails, check that a custom connector uses the full connection link ending in /mcp. The Claude directory version connects in one click without a pasted link. Sign in again and check your workspace’s connector policy. Contact [email protected] for help.