MCP tools

StealAds has an MCP connection, so Claude, ChatGPT, Cursor, Codex and other AI tools can search ads, watch rivals and make ads for you. This page lists every tool and what it does.

What it does

MCP (Model Context Protocol) is a standard way for an AI app to use another product's tools. Connect StealAds once, then ask in plain words: find winning ads in a category, see what a rival keeps running, or adapt an ad for your brand.

Your AI picks the tool and shows you what it found. Anything that spends credits shows the cost first and waits for your approval.

How to connect

Use the connection link https://mcp.stealads.ai/mcp and sign in with your StealAds account. No API key is needed. Step-by-step setup for Claude, ChatGPT, Claude Code, Codex, Cursor and Gemini CLI is on the Connect your AI page at /docs/connect-your-ai.

The Claude directory version is for research in Claude and opens StealAds to make the ad, so it offers fewer tools than the full connection.

Limits

Ad searches return capped pages of examples. They are not a complete inventory, and an empty result does not prove an advertiser has no ads. Run length is evidence an ad kept running, not proof it sold. See Connect your AI for the full library rules.

The tools

56 tools on the full connection, grouped by what you are trying to do. Tools marked asks first show a cost and wait for your approval before anything is spent.

Find ads

Search public Facebook and Instagram ads. Every search returns a capped page of examples, never the whole library.

  • search_ads Search ads by advertiser, category or keywords, with format and run-length filters.
  • find_winning_ads Find ranked examples for a category and up to three related angles, with hooks, captions and cautions.
  • search_advertisers Look up an advertiser by name, website or page link so you can track it.
  • get_ad Open one ad: its hook, copy, run dates and images.
  • show_ad_gallery Show chosen ads as a gallery, where your AI app supports it.

Watch your rivals

Track the competitors you care about and read what they keep running.

  • list_competitors List the competitors saved under a brand.
  • add_competitor Add a competitor to a brand, and optionally start tracking it. asks first
  • start_tracking Start or resume watching a competitor for new ads. asks first
  • resume_tracking Resume watching a competitor you paused. asks first
  • pause_tracking Stop future watching for a competitor.
  • get_tracking_status See whether a competitor is tracked, until when, and how its latest scan went.
  • scan_competitor Check a tracked competitor for new ads now. asks first
  • list_tracked_rival_ads Page through ads from your tracked rivals, including ads that stopped running.
  • get_competitor_analysis Read a tracked competitor's common hooks, angles and longest-running ads.
  • create_playbook Write a Playbook for one competitor: what they keep running and ideas to try against it. asks first
  • list_playbooks See the latest Playbook for each competitor under a brand.
  • get_playbook Read one competitor's Playbook.

Save ads

Keep the ads you want to come back to.

  • save_ad Save an ad, optionally into a collection with a note.
  • list_saved_ads List your saved ads.
  • move_saved_ad Move a saved ad into a collection, or back to unsorted.
  • unsave_ad Remove an ad from your saved list.
  • list_collections List your collections.
  • create_collection Make a new collection.
  • update_collection Rename a collection or change its description.

Make ads

Turn an ad that works into one for your brand. You see the cost and approve it first.

  • quote_steal_ad Preview what adapting an ad for your brand would cost. Nothing is spent.
  • steal_ad Adapt one source ad into an image ad for your brand. asks first
  • create_campaign Make a campaign of one to ten image ads for a brand. asks first
  • get_ad_status Check on an ad that is being made, and get the finished images.
  • list_generation_jobs List the ads you have made, with progress and images.
  • list_campaigns List your campaigns and their latest results.
  • get_campaign_outputs Get the status and finished images for one campaign.
  • get_campaign_output_workspace Review a finished campaign output and its versions.
  • select_campaign_output_version Pick which version of a campaign image to keep.
  • get_campaign_export_descriptor Get the image placements and copy for a finished campaign, ready to pack up.

Edit ad copy

Change the words on a finished image ad.

  • get_creative_workspace Read an ad's current copy and its recent changes.
  • update_copy Save the text and call to action you supply.
  • revise_copy Ask for a rewrite of the copy and preview it before keeping it. asks first
  • apply_copy_revision Keep a rewrite you like.
  • discard_copy_revision Throw a rewrite away.
  • undo_copy_revision Go back to the copy from before a kept rewrite.

Brands and brand images

The details and images StealAds uses when it makes ads for you.

  • list_brands List your brands.
  • get_brand Read one brand's full details.
  • create_brand Create a brand from details you supply.
  • update_brand Change a brand's details.
  • list_brand_assets List a brand's images.
  • register_brand_asset_url Add a brand image from a public link.
  • upload_brand_asset Upload a small brand image.
  • update_brand_asset Edit an image's description or tags.
  • set_primary_brand_asset Choose the main image of its type, such as the logo.
  • delete_brand_asset Remove a brand image.

Weekly drops

The weekly batches of ad ideas StealAds prepares for a brand.

  • get_automation_status See the weekly drop settings for a brand.
  • list_weekly_drops List recent weekly drops and their finished results.

Your account

Check what the connection can do and how much you have left.

  • whoami See which account is connected, its permissions and its brands.
  • get_capabilities See which tools this connection offers and which ask for approval.
  • get_usage See your usage and remaining credits.
  • contact_support Send a question, problem or idea to the StealAds team.

Renamed tools

On November 3, 2026 three tools got clearer names. The old names still work and behave the same, so existing connections and saved prompts keep running. Use the new names in new setups.

  • find_bangersis now find_winning_ads
  • get_breakdownis now get_competitor_analysis
  • get_generation_jobis now get_ad_status
  • generate_creativestill works and runs steal_ad
Previous

Connect your AI
Next

Brand Setup