[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_126":127},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":47,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":47,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":47,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":47,"_82":-5,"_83":58,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","spytrend","moduleId","spytrend-mcp","@spytrend/spytrend-mcp","displayName","Spytrend","tagline","Meta and TikTok advertising analytics with ads, creatives, advertisers, rankings and six workflows.","iconKey","https://spytrend.com/apple-touch-icon.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.spytrend.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1788409635000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.spytrend%2Fspytrend","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1788373260000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/Spytrend/spytrend-mcp","githubRepoFullName","Spytrend/spytrend-mcp","releaseId","ext-spytrend-spytrend-mcp","version","2.1.0","descriptionMarkdown","# Spytrend MCP Server\n\n[![Claude](https://img.shields.io/badge/Claude-Set%20up-1f1f1f?style=flat-square)](docs/quickstart.md#claude)\n[![ChatGPT](https://img.shields.io/badge/ChatGPT-Set%20up-1f1f1f?style=flat-square)](docs/quickstart.md#chatgpt)\n[![Cursor](https://img.shields.io/badge/Cursor-Set%20up-1f1f1f?style=flat-square)](docs/quickstart.md#cursor)\n[![VS Code](https://img.shields.io/badge/VS%20Code-Set%20up-1f1f1f?style=flat-square)](docs/quickstart.md#vs-code)\n\n**Spytrend is an advertising analytics platform.** This repository is the official home of its MCP\nserver: one URL, a browser sign-in, and your AI assistant works with Meta and TikTok advertising\ndata directly — ads, the images and videos behind them, advertisers, and whoever is running them.\nThere is nothing to install and no key to paste: the server runs on our side and you sign in with\nyour Spytrend account, the same one you use on the site. The connection works on every plan,\nincluding the free one; usage is metered in tokens, and you pay for results, not for asking — a call\nthat returns nothing costs nothing. One ad is a single frame. Here you see everything a competitor\nruns.\n\n---\n\n## What this repository is\n\nThis repository holds the public catalogue metadata for a server we host (see `server.json`), plus\nsetup instructions and recipes. The server itself is part of the Spytrend platform and its source\nis not open. There is no package here to download and no code to run — connecting is a URL and a\nsign-in button.\n\n---\n\n## Connect\n\n**Endpoint**\n\n```\nhttps://mcp.spytrend.com/mcp\n```\n\n**Sign-in:** your Spytrend account, in the browser. No API key, no token to paste.\n\n**Where to find it in your account:** Settings → AI / MCP, or the connection page at\n.\n\nThree steps, whichever client you use:\n\n1. Open your client's connector settings.\n2. Add a remote MCP server and give it the URL above.\n3. Sign in when the browser window opens, and start asking.\n\nPer-client instructions: **[docs/quickstart.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md)**.\n\n

Claude — desktop, CLI and web

\n\nAdd a custom connector in Settings → Connectors, paste the endpoint URL, and complete the sign-in\nin the browser window that opens. Full walkthrough: [docs/quickstart.md#claude](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md#claude).\n

\n\n

ChatGPT

\n\nAdd the endpoint as a connector in Settings, then sign in with your Spytrend account.\nFull walkthrough: [docs/quickstart.md#chatgpt](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md#chatgpt).\n

\n\n

Cursor · Codex · VS Code

\n\nAdd the endpoint above as a remote MCP server of type `streamable-http`, then sign in through the\nbrowser when prompted. Full walkthrough: [docs/quickstart.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md).\n

\n\nAny client that speaks Streamable HTTP will work — the four above are simply the ones we have\nwritten up.\n\n---\n\n## What you get\n\n**Search.** Ask what is being advertised in a market, a category or a country — by keyword, by\nbusiness category, by format, by run dates. Search the advertising material itself, too: the images\nand videos a person actually sees.\n\n**One record, in full.** Open a single ad, an advertiser, or the account behind a group of ads, and\nget the whole record: the text, the material, the pages, the domains, the countries, the run dates.\n\n**Rankings.** See what is newly picking up in a country, a category or an app — a starting point\nwhen you have no specific competitor in mind.\n\n**Folders and balance.** Save what you find to a folder and pull it back later. Check your balance,\nfor free, at any time.\n\n**Autonomous agents.** An agent can register itself and start sampling the database before anyone\nsigns up: archive results, market-level rankings, ten rows a call, no media. Linking it to a\nSpytrend account opens the rest. See [docs/quickstart.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md#autonomous-agents).\n\n---\n\n## Everything a competitor runs\n\nOne ad is a single frame. Here you see the whole body of work: every ad, every video, every page,\nevery domain, every country and every run date, gathered into one record. Open the account behind\nthe advertising once and the whole picture is already assembled — you are not clicking through tabs\nbuilding it yourself.\n\nMost services answer one question: *show me this ad.* This one answers a different question:\n*who is running it, and what else are they running?*\n\n---\n\n## Tools\n\n| Tool | What it does | Cost |\n|---|---|---|\n| `search_ads` | Search Meta and TikTok ads by keyword, country, business category, format and run dates | 1 token per row returned |\n| `search_creatives` | Search the advertising material itself — the images and videos a person actually sees | 1 token per row returned |\n| `search_advertisers` | Find advertisers by name, domain, country or business category | 1 token per row returned |\n| `search_webmasters` | Find the company or person behind a group of ads — one account running many ads across pages, domains and countries | 1 token per row returned |\n| `search_hubs` | Explore where advertising sends people, grouped by destination: social platforms, app stores, marketplaces, shops | Catalogue of destinations: free. Profiles inside one: 1 token per row |\n| `search_shops` | Look up a domain as a traffic surface, with monthly visit estimates and how confident each estimate is | 1 token per row returned |\n| `get_ad` | Return the full record of one ad: text, material, advertiser, countries, run dates, destination page | 1 token |\n| `get_advertiser` | Return one advertiser in full: pages, countries, business categories | 1 token |\n| `get_webmaster` | Return everything the account behind a group of ads runs, in a single record | 1 token |\n| `get_creative` | Return the record of one image or video: where it ran and how often it was run again | 1 token |\n| `get_shop` | Return one domain's full profile | 1 token |\n| `get_media` | Download the image or video file itself | 1 token per ad · 10 per creative |\n| `get_trends` | Return rankings for a country, category or app, including what is newly picking up | 1 token per row returned |\n| `get_ads_analytics` | Return 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 advertiser | Pro and above · 1 token per breakdown row |\n| `find_similar_ads` | Find ads that carry the same material as one you already have | 1 token per row returned |\n| `find_similar_creatives` | Find images and videos that look the same as one you already have | 1 token per row returned |\n| `find_similar_webmasters` | Find accounts that advertise like one you already have | 1 token per row returned |\n| `get_webmaster_similarity_facets` | Show on which grounds two accounts look alike, before you ask for the list | Free |\n| `add_to_favorites` | Save an ad, an image or video, an advertiser, a destination or an account to a folder | Ads 1 token · creatives 10 · everything else free |\n| `list_favorites` | Return what is in your folders | Free |\n| `get_usage` | Show your plan, your balance and what each call costs | Free |\n\n> A page returns 20 rows unless you ask for more, and never more than 200. You are charged for rows\n> actually delivered — a short page refunds the difference automatically. The TikTok corpus\n> (`source=tiktok`, Pro plan and above) is priced separately at 100 tokens per delivered row.\n\nEach tool with its *use when* / *do not use* guidance, its return shape and an example request:\n**[docs/tools.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/tools.md)**.\n\n**One word explained.** In this product, a *webmaster* is the company or person behind a group of\nads: one account running many ads across different pages, domains and countries. The tool names keep\nthe original word; the descriptions do not depend on it.\n\n---\n\n## Skills\n\nSix ready-made workflows for Claude Code and Codex live in [skills/](https://github.com/Spytrend/spytrend-mcp/blob/main/skills/): map a vertical,\nprofile an advertiser or the account behind a group of ads, review a website, search by keyword,\ndiscover shops. Each skill is a plain folder — copy it into your assistant's skills directory and ask\nin plain language; the skill decides which tools to call and renders a report. Install steps and the\nshared contract: [skills/README.md](https://github.com/Spytrend/spytrend-mcp/blob/main/skills/README.md).\n\nOne-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.\n\n---\n\n## Recipes\n\nThese are the things people ask their assistant on day one. Type the request in your own words — the\nassistant picks the tools.\n\n| Recipe | What you ask for |\n|---|---|\n| [Find who else is advertising in your market](https://github.com/Spytrend/spytrend-mcp/blob/main/examples/find-competitors.md) | Who is advertising in your space right now, and what are they running |\n| [Match to a business type](https://github.com/Spytrend/spytrend-mcp/blob/main/examples/by-business-type.md) | Advertising from businesses like yours — no competitor names needed |\n| [Top ads in one market](https://github.com/Spytrend/spytrend-mcp/blob/main/examples/top-of-niche.md) | What is running in a category, sorted by how long it has been up |\n| [What's running right now in an industry](https://github.com/Spytrend/spytrend-mcp/blob/main/examples/running-now.md) | What is new and picking up, and what has been running for a while |\n\n---\n\n## Credits and plans\n\nUsage is metered in **tokens**, from one balance. **You pay for results, not for asking:** a call\nthat returns nothing costs nothing, and a page shorter than you asked for refunds the difference.\n\n- One delivered row or record — **1 token**. That covers a row of search results, a row of rankings,\n and an advertiser, account, destination or creative opened in full.\n- Downloading the material itself — **1 token** for an ad, **10** for a creative.\n- The TikTok corpus (`source=tiktok`, Pro and above) — **100 tokens** per delivered row.\n- Checking your balance, listing your folders, and the catalogue of destinations — **free**.\n\nThe free Starter plan comes with **500 tokens, and they do not expire**. Every paid plan comes with\n**40,000 tokens a month** — about 2,000 default-sized searches. Enterprise limits are set with\nsupport.\n\nThe connection works on every plan, including the free one. **On the free Starter plan results are\nlimited to the archive — nothing from the last 90 days.** Fresh advertising is what the paid plans\nprovide; it is the same boundary as the free tier on the site. Your assistant can always ask\n`get_usage` — it is free and it answers from the server itself. Current pricing:\n\n\nDetails, along with what the assistant sees when the balance runs out:\n**[docs/limits.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/limits.md)**.\n\n---\n\n## Documentation\n\n| File | What is in it |\n|---|---|\n| [docs/quickstart.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/quickstart.md) | Connecting in five minutes, per client |\n| [docs/tools.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/tools.md) | Every tool: what it does, when to use it, when not to, what comes back |\n| [docs/limits.md](https://github.com/Spytrend/spytrend-mcp/blob/main/docs/limits.md) | Credits, limits, plans, and what an error looks like |\n| [examples/](https://github.com/Spytrend/spytrend-mcp/blob/main/examples/) | Four recipes: what to ask, what comes back, how to read it |\n| [skills/](https://github.com/Spytrend/spytrend-mcp/blob/main/skills/) | Six ready-made workflows for Claude Code and Codex, with install steps and the shared contract |\n| [server.json](https://github.com/Spytrend/spytrend-mcp/blob/main/server.json) | Catalogue metadata, published to the official MCP registry |\n| [llms.txt](https://github.com/Spytrend/spytrend-mcp/blob/main/llms.txt) | A short machine-readable map of this connection for AI assistants |\n\n---\n\n## Support\n\nQuestions about connecting, access or your account: \n\nSomething wrong in this repository — a broken link, an instruction that does not match what you see\non screen: open an issue.\n\nSecurity reports go through a separate route, never through issues: see [SECURITY.md](https://github.com/Spytrend/spytrend-mcp/blob/main/SECURITY.md).\n\n---\n\n## License\n\nMIT — see [LICENSE](https://github.com/Spytrend/spytrend-mcp/blob/main/LICENSE). The licence covers the contents of this repository: documentation,\nmetadata and examples. The server itself is part of the Spytrend platform.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","iconType","image","upstream",{"_111":112,"_113":114,"_115":116,"_117":118,"_119":120,"_121":122},"requiredSecrets",[],"tags",[98,99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_96":58,"_97":58},"ratingAvg","reviewCount","ad-analytics","ad-intelligence","advertising","ai-assistant-tools","chatgpt","claude","competitive-analysis","creative-analysis","cursor","facebook-ads","marketing-analytics","meta-ads","tiktok-ads-mcp","topics",[98,99,100,101,102,103,104,105,106,107,108,123,124,109,125,110],"license","MIT","language","Python","registryName","com.spytrend/spytrend","homepage","https://spytrend.com/mcp/","packages",[],"mcp","mcp-server","model-context-protocol","ENV",{"_128":129,"_130":131,"_132":133},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]