We use optional cookies to analyze traffic and personalize content.
The competitive-intelligence feed your agents can call
Point your AI agents at RivalSweeper and pull competitor signals on demand: prices, promotions, ads, AI visibility and more, over MCP and REST. Included in your RivalSweeper plan, or a prepaid API key if you build without one.
RivalSweeper customers: add the MCP server and sign in with your RivalSweeper account. Developers without a plan: request an API key and we'll get back to you within 24 hours. Connecting and listing the tools needs no sign-in.
Live endpoints
MCP POST https://mcp.rivalsweeper.com/mcp
REST https://mcp.rivalsweeper.com/openapi.json
Agent-native
Built to be called by software, not clicked by people. MCP and REST over the same signals.
Included in your plan
Sign in with your RivalSweeper account and every tool is part of your plan. Nothing extra to buy.
Prepaid keys for developers
No RivalSweeper plan? Use a prepaid API key: 1 credit = $0.02, no data = no charge, no contract.
How it works
Four steps, from your agent's request to a signal it can act on.
Your agent calls RivalSweeper
Over MCP or a plain REST request, your agent asks for the exact signal it needs: a price, a promotion, a readiness score, a full brand snapshot.
It gets the signal back, freshness-stamped
Every response carries the time we captured the data, so your agent always knows how current the answer is before it acts.
It counts against your plan or your credits
Signed in with your RivalSweeper account, each answer with data uses 1 call from your plan's monthly allowance. On a developer API key it debits prepaid credits, so the balance is a hard ceiling.
No data for a domain? No charge
If we have nothing for the domain your agent asked about, the call comes back empty and costs nothing: no plan call and no credits. Only answers that carry data count.
Monitoring competitor prices with an AI agent
Your agent connects once, then makes three calls: check what we have for a competitor's site, read its prices, and watch for moves. Every answer carries the time the data was captured.
Step 1
Check coverage first
check_brand_data_coverage
Tells the agent whether RivalSweeper has prices for the domain, when a price was last read and the share of priced products read in the last 7 days.
Free
Step 2
Read the prices
get_brand_price_statistics
Minimum, maximum, average and median price with sample products, optionally filtered by product name (for example "leggings").
1 credit on an API key
Step 3
Watch for moves
get_significant_competitor_changes
Price drops and increases over 10%, new promotions and stock-status flips over the last 1 to 90 days (7 by default).
2 credits on an API key
Over MCP (the tool call your agent's MCP client sends)
POST https://mcp.rivalsweeper.com/mcp
Authorization: Bearer rsk_...
Content-Type: application/json
Accept: application/json, text/event-stream
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "get_brand_price_statistics",
"arguments": {"domain": "competitor-store.com", "query": "leggings"}}}Over REST
curl -H "Authorization: Bearer rsk_..." \ "https://mcp.rivalsweeper.com/v1/signals/price?domain=competitor-store.com"
What it costs. Signed in with a RivalSweeper account, these calls come from your plan: 2,000 per billing month on Basic, 10,000 on Pro and unlimited on Enterprise. On a prepaid developer API key, 1 credit = $0.02, so a price read is about $0.02 and a changes check about $0.04. No data = no charge.
What to know first. Price and stock data come from supported sites, and coverage varies by site. RivalSweeper checks competitor sites daily, not in real time, and it does not reprice your products. If a domain has no data yet, the agent can ask RivalSweeper to start monitoring it. AI assistants such as Claude connect with one URL: see the MCP setup steps.
The signals your agents can pull
Signed in with your RivalSweeper account, every signal is included in your plan. Developer API keys pay in credit tiers, because a single raw fact and a written competitive brief are not worth the same.
Core signals
AtomicThe high-volume facts an agent asks for again and again.
Competitor price
Current price for a brand and SKU or category, dated.
Promotions
Active discounts and offers running right now, with start dates.
AI and agent-readiness score
The six-signal score for how ready a domain is for AI shopping agents.
Brand snapshot
BundleEvery current signal for one brand-day, returned in a single call.
Brand snapshot
Price, promotions, and readiness for a brand bundled together, so your agent makes one call instead of five.
History
PremiumThe time-series behind any signal, over the window you choose.
Signal history
How a price, promotion, or score moved across days, weeks, or months.
Synthesis
SynthesisWritten analysis, not raw data. Where the interpretation lives.
SWOT delta and competitive summary
A synthesized competitive brief and change narrative for a brand, written for an agent to act on.
Coming soon
More raw signals are on the roadmap. We add a signal only when it is cleanly ours to share and reliably fresh, so your agent can trust every answer it gets.
Two front doors, one dataset
Connect the way your stack already works. Same data, same freshness stamp.
Call it over MCP
Connect the RivalSweeper Signals MCP server and any MCP-compatible agent can discover and call the signals directly. Sign in with your RivalSweeper account, or use a developer API key. This is the agent-native path.
Or call it over REST
Prefer plain HTTP? Every signal is a REST call with your API key. Ideal for teams whose pipelines and agents are not on MCP yet. Same data, same pricing, same freshness fields on every response.
Pricing that scales with your agents
RivalSweeper customers pay nothing extra: Signals is included in every plan, at 2,000 calls per billing month on Basic, 10,000 on Pro and unlimited on Enterprise. Developers without a plan prepay credits.
The credit prices below are for developer API keys. Looking for the RivalSweeper platform (dashboard, reports, alerts and Signals included)? See the platform subscription plans.
1 credit = $0.02 USD
On a developer API key you prepay credits, and every answer with data draws them down. The dollar amounts below are simply the credit cost converted to USD, not a separate charge. All prices are in USD ($).
| Call type | Unit | Cost (credits) | ≈ USD |
|---|---|---|---|
| Atomic signal | Per query | 1 credit | ≈ $0.02 |
| Bundle (brand snapshot) | Per brand-day | 15 credits | ≈ $0.30 |
| History | Per brand-signal-month | From 5 credits | ≈ $0.10 |
| Synthesis (SWOT / brief) | Per generated brief | 25 credits | ≈ $0.50 |
Credits are the unit of account, and 1 credit = $0.02 USD. An atomic signal is 1 credit, a brand snapshot 15, and a synthesis brief 25, so usage is easy to reason about across every signal. All prices in USD ($).
Pay As You Go
- Buy credit packs on this page whenever you like
- Bigger top-ups earn up to +20% bonus credits
- List price per call, optional monthly spend cap
- Docs and email support
Need custom credit volume, negotiated rates, or an SLA? Talk to us.
Buy credits
Bigger packs earn bonus credits.
- 1Pick a pack$40 earns +10% bonus credits, $80 earns +20%.
- 2Pay with PaddleCard or PayPal, in your local currency where supported.
- 3Credits land automaticallyOn your Signals account once paid. Every call draws them down.
The email your Signals API key was issued to. Credits go to that account.
$20
1,000 credits
≈ $0.020 per credit
$40
2,200 credits
≈ $0.018 per credit
$80
4,800 credits
≈ $0.017 per credit
Payments are processed by Paddle, our merchant of record: card or PayPal, in your local currency where supported, with any local tax worked out at checkout. All prices in USD ($).
Starter credits for developers*
Request a developer API key and every approved company starts with 50 credits (valid 30 days, one per company), no card required. Wire your agent in, watch it pull real signals, and only add credits once it earns its keep. All prices in USD ($).
* For qualified brands only.
Freshness on every call
A capture timestamp on every response, so your agent never acts on data it cannot date.
Hard spend ceilings
Plans stop at their monthly allowance; a developer key stops at its prepaid balance, with an optional monthly cap on top. A runaway agent loop can never drain more than you allow.
No data, no charge
Empty answers cost nothing. You pay for signals, not requests.
Questions, answered
What is the best API for monitoring competitor prices with an AI agent?
We publish RivalSweeper, so weigh this answer with that in mind. Look for four things: your agent can call it directly over MCP instead of through glue code, every price is dated, you pay only for answers that carry data, and spend has a hard ceiling. RivalSweeper Signals does all four. The agent connects to https://mcp.rivalsweeper.com/mcp (or calls REST), checks coverage for free, then calls get_brand_price_statistics for a competitor's price range, median and sample products, and get_significant_competitor_changes for price moves over 10%, new promotions and stock flips. It is included in RivalSweeper plans; without a plan, a prepaid API key costs 1 credit ($0.02) per price read, 2 credits for a changes check, and nothing when there is no data. Price data comes from supported sites and is checked daily, not in real time, and RivalSweeper does not reprice your products.
I already use RivalSweeper. Is Signals included in my plan?
Yes. Add the RivalSweeper Signals MCP server (https://mcp.rivalsweeper.com/mcp) to Claude or any MCP client and sign in with your RivalSweeper account. Each answer with data uses 1 call from your plan's allowance, with nothing to buy: Basic 2,000 and Pro 10,000 per billing month, Enterprise unlimited, and the 14-day free trial includes 200. Answers with no data are free. Calls cover your own site and the competitor brands you track; a company Admin can add a competitor straight from Claude, within your plan's competitor limit, and a newly added brand can take up to 24 hours before data appears. Prepaid credits and API keys are for developers without a RivalSweeper plan.
I don't have a RivalSweeper plan. How do I get a developer API key?
Request a key from this page and we will get back to you within 24 hours. Approved companies (qualified brands only) start with 50 credits, valid for 30 days and one per company, no card required. Point your agent at the key and it can start pulling signals in minutes. You can look around before that: connecting and listing the tools needs no sign-in.
How do credits work for developer API keys?
Credits apply to developer API keys only; RivalSweeper customers use their plan's allowance instead. Credits are the unit of account, and 1 credit is $0.02 USD (all prices are in USD). Atomic signals cost 1 credit, a brand snapshot 15, and a synthesis brief 25. You buy credit packs on this page and every call draws down from your prepaid balance. Bigger packs earn bonus credits: $20 buys 1,000 credits, $40 buys 2,200 (+10%) and $80 buys 4,800 (+20%). Payment is by card or PayPal through Paddle, our merchant of record, and the credits land on your account automatically once the payment goes through. There is no monthly bill to chase. You see a running usage statement, not a surprise invoice, so there is nothing to collect at month end.
What happens if you have no data for a domain?
You are not charged. Billing is triggered by an answer that carries data, not by the request itself. If we have nothing for the domain, the call returns empty and costs zero credits.
How fresh is the data?
Every response includes a freshness timestamp and the time the underlying data was captured. Your agent can read those fields and decide whether the answer is current enough to act on. If we ever serve data older than your plan's freshness promise, that call is credited back.
How do I connect over MCP versus REST?
Two front doors, one dataset. Connect the RivalSweeper Signals MCP server (https://mcp.rivalsweeper.com/mcp) and any MCP-compatible agent can discover and call the signals directly, no glue code: sign in with your RivalSweeper account or use a developer API key. Prefer REST? Call the core signals over standard HTTP with your API key. Same freshness stamp either way.
Can I cap spend and set rate limits?
Yes. On a RivalSweeper plan, calls stop at your plan's monthly allowance and are never billed on top. On a developer API key, your prepaid balance is already a hard ceiling: when it runs out, calls stop and nothing is billed. On top of that we can set a monthly credit cap on your account, and per-key rate limits keep traffic predictable.
What signals are available today?
37 MCP tools today. Pricing and promotions: price statistics, active promotions and coupon codes, discount frequency and depth, most-discounted products, and significant changes such as price moves over 10%, new promotions and stock flips. Competitor activity: a competitor-moves feed, newly published products and pages, homepage top links, homepage shelf and markdowns, Brand Radar assortment gaps for multi-brand stores, technology stack, newsletters, social channels and hiring. Ads: a cross-channel ads overview, Meta ads (reach, messages and landing pages), Google ads (Shopping, targeting and creatives) and ads that point to broken pages or expired offers. AI: how AI models describe and cite a brand, a 6-pillar AI-agent readiness score and a weekly AI shopping-agent checkout race. Analysis: SWOT, homepage, product page, catalog and customer reviews, closest competitor brands, a full brand snapshot and weekly predicted competitor moves. Your account: tracked brands, usage and plan, to-dos and upcoming events. Free tools check data coverage and request missing signals or new brands. Tools that draw on your RivalSweeper app data need a RivalSweeper sign-in; developers on a prepaid key get the core signals: prices, promotions, significant changes, competitor sets, homepage top links, AI-readiness and the brand snapshot.
