Skip to main content

Documentation Index

Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

The MCP server exposes 13 pricing tools plus a wallet_info utility. Below is what each does and what to ask in natural language — Claude (or your MCP client) handles parameter parsing, you don’t have to think in arguments.

​
Shopper

Per-query price: $0.01

​
best_price

Find the cheapest current price for a product across covered retailers.
“What’s the cheapest place to buy AirPods Pro right now?” “Find me the best price for a Dyson V15 in Canada.”

​
price_history

Show price trends over time for a specific product.
“How has the Sony WH-1000XM5 changed in price over the last 90 days?” “Has the Dyson V15 ever been cheaper than $549?”

​
deal_finder

List products currently below their typical price in a category.
“Show me the best deals on espresso machines this week.” “What’s on sale in cordless vacuums under $400?”

​
price_drop_alert

Surface products whose prices dropped recently.
“Which TVs have dropped in price in the last 7 days?” “Any recent price drops on Bose headphones?”

​
Marketing

Per-query price: $0.01

​
competitive_landscape

Per-retailer pricing snapshot for a category or competitor set.
“How do AirPods Pro prices compare across Amazon, Walmart, and Best Buy?” “Show me the competitive landscape for robot vacuums under $500.”

​
brand_tracker

All products from a brand with current price + availability.
“Track all Bose headphone listings in the US.” “What KitchenAid stand mixers are currently in stock and what do they cost?”

​
promo_intelligence

Promotional activity by retailer or brand — who’s running deals, how deep, how often.
“What promotions has Walmart been running on KitchenAid this quarter?” “How aggressive are Amazon’s promos on Apple accessories vs. Best Buy’s?”

​
share_of_shelf

Percentage of category listings that each brand occupies — a digital-shelf-share signal.
“What’s Apple’s share of shelf in wireless earbuds?” “Which brand dominates listings in the cordless drill category?”

​
price_positioning

Premium / mid / value positioning by brand within a category.
“Where does Anker sit in wireless charging — premium or value?” “Show me the price positioning of all major brands in robot vacuums.”

​
Analyst

Per-query price: $0.02

​
inflation_tracker

Period-over-period price change for a category.
“What’s the inflation rate for grocery essentials in the US over the last 6 months?” “How much have TV prices changed year-over-year?”

​
price_dispersion

Spread of prices for a single product across retailers.
“How much price variance is there for the iPhone 16 Pro across US retailers?” “Which products in the laptop category have the widest price spread?”

​
retailer_index

Average pricing posture of a retailer relative to a category baseline.
“Is Costco actually cheaper than Walmart on average for grocery items?” “Where does Target sit on the price index for home goods?”

​
category_summary

Statistical pricing summary for a category — distribution, median, range.
“Give me a pricing summary for cordless vacuums under $500.” “What’s the price distribution for noise-cancelling headphones?”

​
Utility

​
wallet_info

Show the MCP’s wallet addresses, balance per chain, and funding instructions. Free — no payment required.
“What’s my Crush wallet balance and where do I send USDC?”

​
Filters

Most tools accept these optional filters. You don’t pass them directly — the MCP infers them from your prompt (“in Canada”, “on Amazon”, “last 30 days”):
FilterValues
countryus or ca (defaults to us)
retailere.g. amazon, walmart, costco
daysinteger lookback window (where applicable)

​
Sample response

A best_price call for “wireless earbuds” returns something like: 
{
  "query": "wireless earbuds",
  "country": "US",
  "best": {
    "retailer": "amazon",
    "price": 89.99,
    "currency": "USD",
    "title": "Apple AirPods (3rd Generation)",
    "url": "https://amazon.com/...",
    "in_stock": true,
    "scraped_at": "2026-04-28T11:14:22Z"
  },
  "alternatives": [
    { "retailer": "walmart", "price": 99.00, "..." },
    { "retailer": "target", "price": 99.99, "..." }
  ]
}
The MCP returns these payloads to Claude, which summarizes them in natural language — you’d see something like “The cheapest wireless earbuds right now are AirPods 3rd Gen on Amazon at $89.99, with Walmart $9 higher and Target close behind.”