Chat with your data over MCP

Connect Brandsearch to Claude, ChatGPT, Cursor, and any other AI tool that speaks MCP — then just ask, in plain English, anything about your competitors and your market. No dashboards, no exports, no code.

Get your API key Connect your AI

brandsearch · connected

Show me Nike’s top-spending Meta ads this year

get_brand_summarynike.com

Nike has 47 active Meta ads. The top spender is a video campaign at €184k EU spend — here are the top 10, with creatives and links.

Connect your AI

It takes about two minutes, and it works the same way everywhere: paste one URL, sign in once.

https://api.brandsearch.co/v1/mcp

That single URL works in every tool. You sign in with OAuth from inside the AI — once — and stay connected for 30 days, with no API keys to manage. Pick your tool below to see the exact steps.

Other MCP clients

Any client that supports remote MCP servers over HTTPS will work. Point it at the MCP URL above and follow the OAuth prompt.

For Claude Desktop, Cursor, Gemini, and any CLI that takes a JSON config, the entry looks like:

mcp config

{
  "mcpServers": {
    "brandsearch": {
      "url": "https://api.brandsearch.co/v1/mcp"
    }
  }
}

What you can ask

Once connected, just talk to your AI normally. The AI picks the right tool and arguments automatically.

Brands

“Find DTC beauty brands with 1M+ monthly visits and active Meta ads”

Meta ads

“Show me Nike's top 10 highest-spending Meta ads from 2025”

Brand profile

“Compare Allbirds and Nike — give me a summary of each brand”

TikTok posts

“Discover trending TikTok posts in the Pet Supplies niche”

Aggregates

“Get the dashboard for Glow Recipe's Meta ads — funnel, CTAs, top countries”

Products

“List the bestsellers for allbirds.com — title, price, and URL”

Account

“How many requests do I have left today?”

System

“Is today's Meta ads data ready yet?”

Image, video, and thumbnail URLs come back with every MCP tool, just like over HTTP — so your AI can show or link to ad creatives, product images, and brand logos directly.

Available tools

The MCP server exposes 30+ tools. They map 1:1 to the API endpoints documented elsewhere in this site, with sensible defaults so the AI doesn't have to know every parameter.

Brands

Name
search_brands
Type
tool
Description
Filter brands by niche, monthly visits, active Meta ads, product count, apps, or technologies.
Name
discover_brands
Type
tool
Description
Random sample of trending brands. The right tool for "show me brands" / "give me examples".
Name
get_brand
Type
tool
Description
Full details for a brand by domain (e.g., nike.com).
Name
get_brand_by_url
Type
tool
Description
Full details for a brand by full website URL.
Name
get_brands_by_ids
Type
tool
Description
Batch fetch up to 100 brands by ID.
Name
lookup_brand
Type
tool
Description
Free-form search by brand name, domain, or social handle.
Name
lookup_brands_batch
Type
tool
Description
Batch look up to 50 identifiers in one call.
Name
query_brands
Type
tool
Description
Same as search_brands but takes a JSON filter body. Use when filters get long.
Name
get_brand_summary
Type
tool
Description
Profile + active Meta ads + products in a single call. Best for "tell me about X".
Name
get_brand_advertisers
Type
tool
Description
The Facebook/Meta pages running ads for a brand.

Ads & posts

Name
get_brand_ads
Type
tool
Description
Ads or posts for a specific brand on meta, tiktok, or instagram.
Name
search_meta_ads
Type
tool
Description
Search every Meta ad we track by copy, spend, reach, targeting, dates.
Name
search_tiktok_ads
Type
tool
Description
Search every TikTok post by description, engagement, duration.
Name
search_instagram_posts
Type
tool
Description
Search every Instagram post by caption, hashtags, engagement.
Name
query_meta_ads
Type
tool
Description
JSON-body counterpart of search_meta_ads.
Name
query_tiktok_ads
Type
tool
Description
JSON-body counterpart of search_tiktok_ads.
Name
query_instagram_posts
Type
tool
Description
JSON-body counterpart of search_instagram_posts.
Name
get_meta_ad
Type
tool
Description
Single Meta ad by ID.
Name
get_tiktok_ad
Type
tool
Description
Single TikTok post by ID.
Name
get_instagram_post
Type
tool
Description
Single Instagram post by ID.
Name
get_meta_ad_by_meta_id
Type
tool
Description
Lookup a Meta ad by its Meta Ads Library numeric ID — the one in facebook.com/ads/library/?id=... URLs.
Name
get_ad_by_url
Type
tool
Description
Cross-platform resolver: paste any Meta Ads Library, TikTok video, or Instagram post/reel URL and get back the matching ad/post (with a platform field for routing).
Name
discover_meta_ads
Type
tool
Description
Random high-quality Meta ads.
Name
discover_tiktok_ads
Type
tool
Description
Random viral TikTok posts.
Name
discover_instagram_posts
Type
tool
Description
Random viral Instagram posts.

Aggregates (dashboards)

Name
get_brand_ads_aggregates
Type
tool
Description
Six-dimension Meta ads dashboard for a single brand (media mix, funnel, CTAs, demography, spend).
Name
get_brand_posts_aggregates
Type
tool
Description
TikTok or Instagram dashboard for a single brand.
Name
get_meta_ads_aggregates
Type
tool
Description
Meta ads dashboard across all brands matching a filter slice.
Name
get_tiktok_ads_aggregates
Type
tool
Description
TikTok dashboard across all brands.
Name
get_instagram_posts_aggregates
Type
tool
Description
Instagram dashboard across all brands.

Folders & boards

The user's Swipe folders (Saved Ads, Saved Advertisers, Tracked Brands) and boards are accessible from the AI. Every folder tool takes a folder_type of ads, brands, or spectre. The AI can browse a user's saved collections, resolve them to full ad/brand records, create and rename folders, save and remove items, and delete folders — all without leaving the chat.

Name
list_folders
Type
tool
Description
Paginated list of the user's folders for a given folder_type.
Name
get_folder
Type
tool
Description
One folder's metadata and the IDs of its saved items.
Name
get_folder_ads
Type
tool
Description
Resolve an ads or spectre folder to full ad records (Meta / TikTok / Instagram). spectre folders also accept max_ads_per_brand, status, is_video, is_image, sort_by, sort_order.
Name
get_folder_brands
Type
tool
Description
Resolve a brands or spectre folder to full brand records.
Name
get_board
Type
tool
Description
Get a board and its linked directories by ID.
Name
create_folder
Type
tool
Description
Create a new folder for the user. Takes folder_type and a name (1-100 chars).
Name
add_to_folder
Type
tool
Description
Save an item to a folder. Per kind: ads → url + type (one of meta/tiktok/instagram) + optional ad_id; brands → advertiser_id (Meta page ID); spectre → either url + page_id (Meta Library mode) or brand_id + scrapman_id (tracked-brand mode). Idempotent: re-saving the same item just attaches it to the additional folder and returns already_in_folder: true.
Name
rename_folder
Type
tool
Description
Rename a folder. Takes folder_type, folder_id, and a new name (1-100 chars). Works on a folder the user owns or has edit access to; a duplicate name returns swipe_folder_name_taken.
Name
delete_folder
Type
tool
Description
Delete a folder (owner only). Takes folder_type and folder_id. Removes the folder and its item links; the saved ads/advertisers/brands themselves are kept.
Name
remove_from_folder
Type
tool
Description
Remove a saved item from a folder without deleting the item itself. Takes folder_type, folder_id, and item_id (the saved_ad_id / saved_advertiser_id / tracked_brand_id from get_folder). Idempotent: removing an absent item returns already_removed: true.

Products & metadata

Name
get_products
Type
tool
Description
Products sold by a brand. product_type can be all, bestsellers, or latest.
Name
get_facet
Type
tool
Description
Canonical reference values (e.g., apps, technologies, niches, country-codes). Use when you need to know the valid values for a filter.
Name
get_usage
Type
tool
Description
Current API usage + remaining daily/monthly quota.
Name
get_system_freshness
Type
tool
Description
Latest timestamps for brands, Meta ads, TikTok posts, and Instagram posts. "Is today's data ready?"

Rate limits

The MCP endpoint has its own rate limits separate from the REST API. If your AI hits them, it will get a 429 too_many_requests response with a Retry-After header — the AI will typically retry after the suggested wait. Underlying tool calls still count against your normal API quota; check it any time with the get_usage tool.

Tips for getting good results

Use discover_brands for vague prompts. "Show me some cool DTC brands" should hit discover_brands, not search_brands with no filters.
Use get_brand_summary over chained calls. It bundles profile + ads + products in one round trip.
Use get_facet to validate values before filtering. If the AI is unsure whether Klaviyo is the canonical app name, it can call get_facet("apps") first.
Use query_* over search_* for long filter sets. JSON body avoids querystring length limits and keeps arrays clean.