Spytrend

com.spytrendPublished by spytrend.comOfficial publisherv2.1.1Updated Nov 2, 2026

Analytics, advertising: Facebook/Meta, TikTok, competitor ads. Free plan; Spytrend OAuth in browser

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Spytrend is a hosted advertising-analytics MCP server that lets an assistant search and open Meta and TikTok ad data, creatives, advertisers and the accounts…

What you can do
  • Search Meta and TikTok ads, ad creatives, advertisers, the accounts behind ad groups, destination hubs and shop domains
  • Open full records for a single ad, advertiser, account, creative or domain, and download the image or video file
  • Get country, category or app rankings, ad-set analytics breakdowns, and find similar ads, creatives or accounts
  • Save items to folders, list them, and check plan, balance and per-call cost
When to use it
Useful when you want an assistant to research competitor advertising: who is running ads in a market or category, what creatives they use, where traffic is sent, and what is newly picking up. It suits marketing and competitive-intelligence questions rather than general web search.
Requirements
A remote Streamable HTTP endpoint; nothing to install locally. A Spytrend account signed in through OAuth in the browser; no API key or token to paste. Works on every plan, including the free one, but usage is metered in tokens.
Before you install
Calls consume tokens from a paid balance: 1 token per delivered row or record, 10 per creative download, and 100 per TikTok row on Pro and above. The free Starter plan is limited to the archive and excludes the last 90 days. The server can save items to your folders, and an agent can register itself and sample the database before anyone signs up.

Installation

In SourceWeft

  1. Open Spytrend in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.spytrend%2Fspytrend/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "spytrend": {
      "type": "http",
      "url": "https://mcp.spytrend.com/mcp"
    }
  }
}

README

Spytrend MCP Server

[Claude] [ChatGPT] [Cursor] [VS Code]

Spytrend is an advertising analytics platform. This repository is the official home of its MCP server: one URL, a browser sign-in, and your AI assistant works with Meta and TikTok advertising data directly — ads, the images and videos behind them, advertisers, and whoever is running them. There is nothing to install and no key to paste: the server runs on our side and you sign in with your Spytrend account, the same one you use on the site. The connection works on every plan, including the free one; usage is metered in tokens, and you pay for results, not for asking — a call that returns nothing costs nothing. One ad is a single frame. Here you see everything a competitor runs.

What this repository is

This repository holds the public catalogue metadata for a server we host (see server.json), plus setup instructions and recipes. The server itself is part of the Spytrend platform and its source is not open. There is no package here to download and no code to run — connecting is a URL and a sign-in button.

Connect

Endpoint

https://mcp.spytrend.com/mcp

Sign-in: your Spytrend account, in the browser. No API key, no token to paste.

Where to find it in your account: Settings → AI / MCP, or the connection page at https://spytrend.com/mcp/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch.

Three steps, whichever client you use:

  1. Open your client's connector settings.
  2. Add a remote MCP server and give it the URL above.
  3. Sign in when the browser window opens, and start asking.

Per-client instructions: docs/quickstart.md.

One-click install: [Install in VS Code]

Claude — desktop, CLI and web

Add a custom connector in Settings → Connectors, paste the endpoint URL, and complete the sign-in in the browser window that opens. Full walkthrough: docs/quickstart.md#claude.

ChatGPT

Add the endpoint as a connector in Settings, then sign in with your Spytrend account. Full walkthrough: docs/quickstart.md#chatgpt.

Cursor · Codex · VS Code

Add the endpoint above as a remote MCP server of type streamable-http, then sign in through the browser when prompted. Full walkthrough: docs/quickstart.md.

Any client that speaks Streamable HTTP will work — the four above are simply the ones we have written up.

What you get

Search. Ask what is being advertised in a market, a category or a country — by keyword, by business category, by format, by run dates. Search the advertising material itself, too: the images and videos a person actually sees.

One record, in full. Open a single ad, an advertiser, or the account behind a group of ads, and get the whole record: the text, the material, the pages, the domains, the countries, the run dates.

Rankings. See what is newly picking up in a country, a category or an app — a starting point when you have no specific competitor in mind.

Folders and balance. Save what you find to a folder and pull it back later. Check your balance, for free, at any time.

Autonomous agents. An agent can register itself and start sampling the database before anyone signs up: archive results, market-level rankings, ten rows a call, no media. Linking it to a Spytrend account opens the rest. See docs/quickstart.md.

Everything a competitor runs

One ad is a single frame. Here you see the whole body of work: every ad, every video, every page, every domain, every country and every run date, gathered into one record. Open the account behind the advertising once and the whole picture is already assembled — you are not clicking through tabs building it yourself.

Most services answer one question: show me this ad. This one answers a different question: who is running it, and what else are they running?

Tools

ToolWhat it doesCost
search_adsSearch Meta and TikTok ads by keyword, country, business category, format and run dates1 token per row returned
search_creativesSearch the advertising material itself — the images and videos a person actually sees1 token per row returned
search_advertisersFind advertisers by name, domain, country or business category1 token per row returned
search_webmastersFind the company or person behind a group of ads — one account running many ads across pages, domains and countries1 token per row returned
search_hubsExplore where advertising sends people, grouped by destination: social platforms, app stores, marketplaces, shopsCatalogue of destinations: free. Profiles inside one: 1 token per row
search_shopsLook up a domain as a traffic surface, with monthly visit estimates and how confident each estimate is1 token per row returned
get_adReturn the full record of one ad: text, material, advertiser, countries, run dates, destination page1 token
get_advertiserReturn one advertiser in full: pages, countries, business categories1 token
get_webmasterReturn everything the account behind a group of ads runs, in a single record1 token
get_creativeReturn the record of one image or video: where it ran and how often it was run again1 token
get_shopReturn one domain's full profile1 token
get_mediaDownload the image or video file itself1 token per ad · 10 per creative
get_trendsReturn rankings for a country, category or app, including what is newly picking up1 token per row returned
get_ads_analyticsReturn the shape of a selection of ads instead of the ads: how many, and how they break down by status, country, business category, destination and advertiserPro and above · 1 token per breakdown row
find_similar_adsFind ads that carry the same material as one you already have1 token per row returned
find_similar_creativesFind images and videos that look the same as one you already have1 token per row returned
find_similar_webmastersFind accounts that advertise like one you already have1 token per row returned
get_webmaster_similarity_facetsShow on which grounds two accounts look alike, before you ask for the listFree
add_to_favoritesSave an ad, an image or video, an advertiser, a destination or an account to a folderAds 1 token · creatives 10 · everything else free
list_favoritesReturn what is in your foldersFree
get_usageShow your plan, your balance and what each call costsFree

A page returns 20 rows unless you ask for more, and never more than 200. You are charged for rows actually delivered — a short page refunds the difference automatically. The TikTok corpus (source=tiktok, Pro plan and above) is priced separately at 100 tokens per delivered row.

Each tool with its use when / do not use guidance, its return shape and an example request: docs/tools.md.

One word explained. In this product, a webmaster is the company or person behind a group of ads: one account running many ads across different pages, domains and countries. The tool names keep the original word; the descriptions do not depend on it.

Skills

Six ready-made workflows for Claude Code and Codex live in skills/: map a vertical, profile an advertiser or the account behind a group of ads, review a website, search by keyword, discover shops. Each skill is a plain folder — copy it into your assistant's skills directory and ask in plain language; the skill decides which tools to call and renders a report. Install steps and the shared contract: skills/README.md.

One-command install: /plugin marketplace add Spytrend/spytrend-mcp then /plugin install spytrend-mcp-skills@spytrend-mcp for Claude Code; npx skills add Spytrend/spytrend-mcp for Claude Code, Codex, Cursor, Copilot, Gemini CLI and 70+ more.

Scenario adapters

Smaller stdio adapters over this same hosted server, each exposing one research scenario with its own tool names. Use them when an assistant should only see one slice of the catalog.

All adapters connect to https://mcp.spytrend.com/mcp and share the same account, plan and tokens.

Community

Built by the community — not maintained by the Spytrend team:

  • dvygolov/spytrend-cli by Daniel Vygolov — a standalone Python CLI and a drop-in agent skill that call this server over Streamable HTTP with OAuth2 client credentials, for agents and scripts that run without an MCP host.

Built something on top of Spytrend MCP? Open an issue with a link and we will add it here.

Recipes

These are the things people ask their assistant on day one. Type the request in your own words — the assistant picks the tools.

RecipeWhat you ask for
Find who else is advertising in your marketWho is advertising in your space right now, and what are they running
Match to a business typeAdvertising from businesses like yours — no competitor names needed
Top ads in one marketWhat is running in a category, sorted by how long it has been up
What's running right now in an industryWhat is new and picking up, and what has been running for a while

Credits and plans

Usage is metered in tokens, from one balance. You pay for results, not for asking: a call that returns nothing costs nothing, and a page shorter than you asked for refunds the difference.

  • One delivered row or record — 1 token. That covers a row of search results, a row of rankings, and an advertiser, account, destination or creative opened in full.
  • Downloading the material itself — 1 token for an ad, 10 for a creative.
  • The TikTok corpus (source=tiktok, Pro and above) — 100 tokens per delivered row.
  • Checking your balance, listing your folders, and the catalogue of destinations — free.

The free Starter plan comes with 500 tokens, and they do not expire. Every paid plan comes with 40,000 tokens a month — about 2,000 default-sized searches. Enterprise limits are set with support.

The connection works on every plan, including the free one. On the free Starter plan results are limited to the archive — nothing from the last 90 days. Fresh advertising is what the paid plans provide; it is the same boundary as the free tier on the site. Your assistant can always ask get_usage — it is free and it answers from the server itself. Current pricing: https://spytrend.com/pricing/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch

Details, along with what the assistant sees when the balance runs out: docs/limits.md.

Documentation

FileWhat is in it
docs/quickstart.mdConnecting in five minutes, per client
docs/tools.mdEvery tool: what it does, when to use it, when not to, what comes back
docs/limits.mdCredits, limits, plans, and what an error looks like
examples/Four recipes: what to ask, what comes back, how to read it
skills/Six ready-made workflows for Claude Code and Codex, with install steps and the shared contract
server.jsonCatalogue metadata, published to the official MCP registry
llms.txtA short machine-readable map of this connection for AI assistants

Support

Questions about connecting, access or your account: https://spytrend.com/contact/

Something wrong in this repository — a broken link, an instruction that does not match what you see on screen: open an issue.

Security reports go through a separate route, never through issues: see SECURITY.md.

License

MIT — see LICENSE. The licence covers the contents of this repository: documentation, metadata and examples. The server itself is part of the Spytrend platform.

Source: README.md at commit 6503707

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v2.1.1LatestOct 5, 2026
  2. v2.1.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts