# RivalSweeper Signals

> 35 eCommerce competitor-intel tools: prices, promos, ads, AI visibility. Plan-included or prepaid.

- name: com.rivalsweeper/signals
- version: 1.7.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 75/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.rivalsweeper%2Fsignals
- tools: https://api.protogrid.dev/v1/servers/com.rivalsweeper%2Fsignals/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "signals": {
      "type": "http",
      "url": "https://mcp.rivalsweeper.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SIGNALS_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${SIGNALS_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 99
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-97% +updated-2d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 75/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 35 of 35 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 5,461 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 77 tool changes in 30 days
- fail `stability.rug_pull`: 1 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 35, about 5,461 tokens to load them all
- tool set hash: 4cbb35fa3495782e69ab73612124194f
- tools last changed: 2026-10-18T18:55:14.060Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.rivalsweeper/signals.svg)](https://protogrid.dev/servers/com.rivalsweeper/signals)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-18 `request_new_brand_monitoring` changed (description) **meaning changed**
  - before: Ask RivalSweeper to add a domain to monitoring. Free; requires an active RivalSweeper plan or a developer account with a positive prepaid balance. First data typically lands within 24-72h.
  - after: Add a rival domain to monitoring. Signed in with RivalSweeper: adds it to your monitored rivals right away (company Admins only; your plan or trial domain limit applies), with first data within about 24h. Developer API keys: queues a monitoring request (needs a positive prepaid balance; first data in 24-72h). Free.
- 2026-10-13 `get_coverage` removed
  - Check which competitive signals RivalSweeper has for an eCommerce domain, with per-signal freshness. Free and non-billable - call this before any billable tool so you never pay for a domain we do not cover.
- 2026-10-13 `get_promotions` removed
  - Active promotions/discount codes for a brand: code, discount type/value, min order, validity window. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 1 credit, no data = no charge).
- 2026-10-13 `request_monitoring` removed
  - Ask RivalSweeper to add a domain to monitoring. Free; requires an active RivalSweeper plan or a developer account with a positive prepaid balance. First data typically lands within 24-72h.
- 2026-10-13 `get_dna_competitors` removed
  - The brand's last-known DNA competitor set: the closest competing brands RivalSweeper identified for a domain, each with name, website, country, home-market flag and match tier, plus the brand's own DNA profile. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 2 credits, no data = no charge).
- 2026-10-13 `get_competitor_price` removed
  - Price statistics (min/max/avg/median) plus recent product samples for a brand, optionally filtered by product-name query. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 1 credit, no data = no charge).
- 2026-10-13 `get_social_stats` removed
  - Social network presence per brand: channels, followers and posting cadence.
- 2026-10-13 `get_newsletter_insights` removed
  - A brand's email newsletter patterns: cadence, send times, themes and offers, from RivalSweeper's newsletter tracking.
- 2026-10-13 `get_tech_stack` removed
  - The software services each brand runs (analytics, marketing, payments, reviews, search, etc.) as detected by RivalSweeper.
- 2026-10-13 `get_new_products` removed
  - Newly published products and pages per brand (from sitemaps), newest first, with type and tags. Default last 7 days, up to 50 rows (max 200).

Full history: https://api.protogrid.dev/v1/servers/com.rivalsweeper%2Fsignals/changes

## Remotes

- https://mcp.rivalsweeper.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.9741379)

## Packages

_none_

## Tools (35)

- `check_brand_data_coverage`: Check which competitive signals RivalSweeper has for an eCommerce domain, with per-signal freshness. Free and non-billable - call this before any billable tool so you never pay for a domain we do not cover.
- `find_ads_with_broken_pages_or_expired_offers`: Ad & Deal Health: live ads that point to broken or out-of-stock pages, ads promoting expired offers, evergreen 'urgency' claims, and expired homepage banners. Checks your own store by default, or one named rival.
- `find_closest_competitor_brands`: The brand's last-known DNA competitor set: the closest competing brands RivalSweeper identified for a domain, each with name, website, country, home-market flag and match tier, plus the brand's own DNA profile. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 2 credits, no data = no charge).
- `get_active_promotions_and_coupons`: Active promotions/discount codes for a brand: code, discount type/value, min order, validity window. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 1 credit, no data = no charge).
- `get_ai_agent_readiness_score`: RivalSweeper 6-pillar AI/agent-readiness score for a domain (schema.org, technical access, content quality, trust, AI-specific, entity recognition) with tier and highlights. Uniquely RivalSweeper data. Included in RivalSweeper plans (developer API keys: 1 credit, no data = no charge).
- `get_ai_model_citation_rate`: Whether AI models cite each brand when answering shopping questions: citation rate overall and by AI platform, plus recent example queries and the cited URLs. RivalSweeper currently samples Google Gemini and OpenAI's open-weight GPT-OSS models.
- `get_ai_shopping_agent_checkout_race`: RivalSweeper's weekly race of AI shopping agents buying the same product from your store and rivals: which stores an agent could complete checkout on, where it got stuck, KPIs and findings.
- `get_brand_price_statistics`: Price statistics (min/max/avg/median) plus recent product samples for a brand, optionally filtered by product-name query. Freshness-stamped. Included in RivalSweeper plans (developer API keys: 1 credit, no data = no charge).
- `get_brand_radar_assortment_gaps`: Weekly Brand Radar for your store vs rivals: brands you are missing (white space), where you lead (moat), depth gaps, price position and discount pressure per brand. For multi-brand retailers; returns no data for single-brand stores.
- `get_brand_swot_analysis`: RivalSweeper's SWOT analysis of a brand over time: strengths, weaknesses, opportunities and threats, and how they changed.
- `get_catalog_analysis`: RivalSweeper's analysis of a brand's product catalog: assortment, categories and pricing structure.
- `get_competitor_moves_feed`: What your rivals changed, newest first: technology and providers, shipping, ads, marketing messages, AI citations, agent readiness, hiring, performance, bestsellers and more (RivalSweeper's Domain Moves feed). Default last 7 days.
- `get_cross_channel_ads_overview`: Cross-channel ads picture (Meta, Google and others) for your brand vs rivals: live and new ads, channel mix, coordinated pushes, gaps vs you, and prioritized insights with suggested actions.
- `get_customer_reviews_analysis`: RivalSweeper's analysis of a brand's customer reviews: recurring themes, sentiment, praise and complaints.
- `get_discount_frequency_and_depth`: How often and how deep each brand discounts: promo days vs observed days, average and max discount %, and promo types, over a window (7-365 days, default 30).
- `get_email_newsletter_insights`: A brand's email newsletter patterns: cadence, send times, themes and offers, from RivalSweeper's newsletter tracking.
- `get_full_brand_snapshot`: Bundle: all current signals for one brand-day - promotions, price stats + samples, AI-readiness - in one call. Included in RivalSweeper plans (developer API keys: 15 credits, no data = no charge).
- `get_homepage_analysis`: RivalSweeper's analysis of a brand's homepage: what it features and emphasizes, offers and messaging, and how it compares with rivals.
- `get_homepage_product_shelf_and_markdowns`: Which products each brand keeps on its homepage shelf and for how long (persistence, slots, best position), with price and markdown - a read on what brands are pushing. Window in days (7-365, default 90).
- `get_homepage_top_links`: A brand's current homepage top links (up to 10) enriched from its catalog and grouped into Products, Categories and Content, in that order. Per link: title, vendor, price + compare-at/on-sale, currency, stock status, URL status (active/inactive), review rating, homepage position, anchor text and last update. A top-level 'comment' flags when pricing and/or stock status are not captured for the domain. Included in RivalSweeper plans (developer API keys: 2 credits, no data = no charge).
- `get_how_ai_models_describe_brand`: How large language models describe a brand when asked shopping questions, by aspect: brand_reputation, competitor_comparison, product_recommendation, brand_review, industry_landscape, brand_sentiment, recommendation_gap. RivalSweeper currently samples Google Gemini and OpenAI's open-weight GPT-OSS models.
- `get_job_openings_and_hiring_trends`: Open roles per brand by department and location, change vs last check, top job titles and newly added or removed jobs - an early read on where a rival is investing.
- `get_most_discounted_products`: A brand's most-discounted products right now (by % or amount) or its newest discounts, with price, full price and discount.
- `get_my_rivalsweeper_todo_list`: Action items RivalSweeper raised for your team (e.g. fix a broken ad landing page, respond to a rival promotion), with priority, status, owner and due date. Default: pending items.
- `get_my_usage_and_plan`: Your own account status. Signed in with RivalSweeper: your plan, tool calls used this month vs. the plan limit, and the domains you can query. Developer API key: prepaid credit balance plus calls and credits per tool over a look-back window (default 30 days). Free; only ever returns your own usage.
- `get_newly_published_products_and_pages`: Newly published products and pages per brand (from sitemaps), newest first, with type and tags. Default last 7 days, up to 50 rows (max 200).
- `get_predicted_competitor_moves`: RivalSweeper's weekly predictions of each tracked brand's likely next moves (e.g. a sale, a launch), with confidence, the evidence behind it, and a short narrative.
- `get_product_page_analysis`: RivalSweeper's analysis of a brand's product pages: the tactics they use (content, imagery, trust signals, offers, cross-sell).
- `get_significant_competitor_changes`: Recent significant changes for a competitor: price drops/increases >10%, new promotions, stock-status flips. Returns a chronological alert feed with a summary. Configurable window (1-90 days, default 7). Included in RivalSweeper plans (developer API keys: 2 credits, no data = no charge).
- `get_social_media_channels_and_followers`: Social network presence per brand: channels, followers and posting cadence.
- `get_technology_stack`: The software services each brand runs (analytics, marketing, payments, reviews, search, etc.) as detected by RivalSweeper.
- `get_upcoming_events_news_and_activity`: Your dashboard agenda: upcoming holidays and retail events in the countries your brands ship to, news mentions (7 days) and recent catalog activity per brand.
- `list_my_tracked_brands`: The brands in your RivalSweeper account: your own site(s) and the rival brands you monitor, with status. Use it to see which domains the other tools can answer for.
- `request_missing_data_signal`: Tell RivalSweeper exactly what signal you need for a domain. We prioritize data collection based on demand. Use this when check_brand_data_coverage shows a signal is missing or when you need data we do not yet track. Free and non-billable.
- `request_new_brand_monitoring`: Add a rival domain to monitoring. Signed in with RivalSweeper: adds it to your monitored rivals right away (company Admins only; your plan or trial domain limit applies), with first data within about 24h. Developer API keys: queues a monitoring request (needs a positive prepaid balance; first data in 24-72h). Free.