> ## 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.

# MCP Tools

> What you can ask Syntalic through Claude Code, Cursor, or any MCP client.

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 Syntalic 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"):

| Filter     | Values                                     |
| ---------- | ------------------------------------------ |
| `country`  | `us` or `ca` (defaults to `us`)            |
| `retailer` | e.g. `amazon`, `walmart`, `costco`         |
| `days`     | integer lookback window (where applicable) |

## Sample response

A `best_price` call for "wireless earbuds" returns something like:

```json theme={null}
{
  "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."*