[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Flipp local retailer flyers](https://spiral.ai/integrations/cursor/flipp-local-retailer-flyers)

# How to Use Flipp local retailer flyers in Cursor

Find retailer flyers available for a shopping area. Use it to choose which ads to inspect before looking for individual products.

|  |  |
| --- | --- |
| Model | Flipp local retailer flyers |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Flipp local retailer flyers in Cursor

- Use Flipp local retailer flyers for Toronto M5V 2T6 and show me which grocery retailers have ads available.
- Use Flipp local retailer flyers to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Flipp local retailer flyers and tell me what changed since last week.
- Check Flipp local retailer flyers and summarize what you find in three bullet points.
- Pull the newest data from Flipp local retailer flyers and give me the result as a table.

## How to set up Flipp local retailer flyers in Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Flipp local retailer flyers**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "flipp-com/deals/list_flyers",
    "input": {
      "postal_code": "<postal_code>"
    }
  }'
```

Then paste one of the prompts above: Cursor finds Flipp local retailer flyers on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## Flipp local retailer flyers tools and prices

- [Flipp weekly ads · List flyers](https://spiral.ai/tools/alexandria/flipp-com/deals/list_flyers) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 500 | 100 | Maximum flyers returned, in Flipp's priority order. |
| category |  | — | Flipp category to keep, case-insensitive (Groceries, Pharmacy, General Merchandise, Black Friday...). |
| merchant |  | — | Retailer name to keep, matched case- and punctuation-insensitively as a substring (cvs matches CVS Pharmacy). |

## What can you do with Flipp local retailer flyers in Cursor?

Build a personal shopping view that turns Flipp's local ads into a retailer shortlist or product comparison. Use flyer discovery, product matches, or individual ad items to answer the shopping question your project handles.

### Plan a grocery trip

Find the grocery flyers for your shopping area, search for milk, eggs, and rice, then inspect the relevant ads for sale dates and product descriptions.

### Compare a household brand

Identify local retailer ads, search for Tide offers, and read the matching flyers to compare the advertised package descriptions and sale periods.

### Prepare for shopping in another city

Check which flyers appear at your destination, look for products you need, and inspect those ads before deciding where to shop.

### Choose a store for a seasonal purchase

Find local retailer flyers, search for an air fryer or holiday baking supplies, and review the relevant flyer items before making a shortlist.

### Build a personal weekly shopping brief

Start with available local flyers, search for your regular purchases, and inspect the ads to summarize offers with their sale periods.

### Check a product against its retailer's ad

Find a retailer's available flyers, search for a specific product, and read the corresponding ad items to review the description and flyer page.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Flipp local retailer flyers in other agents

- [Amp](https://spiral.ai/integrations/amp/flipp-local-retailer-flyers)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/flipp-local-retailer-flyers)
- [Claude](https://spiral.ai/integrations/claude-desktop/flipp-local-retailer-flyers)
- [Claude Code](https://spiral.ai/integrations/claude-code/flipp-local-retailer-flyers)
- [Cline](https://spiral.ai/integrations/cline/flipp-local-retailer-flyers)
- [Codex](https://spiral.ai/integrations/codex/flipp-local-retailer-flyers)
- [Devin](https://spiral.ai/integrations/devin/flipp-local-retailer-flyers)
- [dots](https://spiral.ai/integrations/dots/flipp-local-retailer-flyers)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/flipp-local-retailer-flyers)
- [Gemini](https://spiral.ai/integrations/gemini/flipp-local-retailer-flyers)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/flipp-local-retailer-flyers)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/flipp-local-retailer-flyers)
- [goose](https://spiral.ai/integrations/goose/flipp-local-retailer-flyers)
- [Grok](https://spiral.ai/integrations/grok/flipp-local-retailer-flyers)
- [Grok Build](https://spiral.ai/integrations/grok-build/flipp-local-retailer-flyers)
- [Hermes](https://spiral.ai/integrations/hermes/flipp-local-retailer-flyers)
- [Instinct](https://spiral.ai/integrations/instinct/flipp-local-retailer-flyers)
- [Manus](https://spiral.ai/integrations/manus/flipp-local-retailer-flyers)
- [Muse](https://spiral.ai/integrations/muse/flipp-local-retailer-flyers)
- [Muse Code](https://spiral.ai/integrations/muse-code/flipp-local-retailer-flyers)
- [n8n](https://spiral.ai/integrations/n8n/flipp-local-retailer-flyers)
- [Notion](https://spiral.ai/integrations/notion/flipp-local-retailer-flyers)
- [OpenClaw](https://spiral.ai/integrations/openclaw/flipp-local-retailer-flyers)
- [opencode](https://spiral.ai/integrations/opencode/flipp-local-retailer-flyers)
- [Perplexity](https://spiral.ai/integrations/perplexity/flipp-local-retailer-flyers)
- [Raycast](https://spiral.ai/integrations/raycast/flipp-local-retailer-flyers)
- [VS Code](https://spiral.ai/integrations/vscode/flipp-local-retailer-flyers)
- [Windsurf](https://spiral.ai/integrations/windsurf/flipp-local-retailer-flyers)
- [Zapier](https://spiral.ai/integrations/zapier/flipp-local-retailer-flyers)

## More Cursor guides

- [Fanatics team directory](https://spiral.ai/integrations/cursor/fanatics-team-directory)
- [Flipp product deals search](https://spiral.ai/integrations/cursor/flipp-product-deals-search)
- [Fanatics team and league products](https://spiral.ai/integrations/cursor/fanatics-team-and-league-products)
- [Flipp retailer flyer items](https://spiral.ai/integrations/cursor/flipp-retailer-flyer-items)
- [Fanatics product search](https://spiral.ai/integrations/cursor/fanatics-product-search)
- [GitHub account search](https://spiral.ai/integrations/cursor/github-account-search)

## Questions about Flipp local retailer flyers in Cursor

**Can Cursor use Flipp local retailer flyers?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Flipp local retailer flyers like any built-in tool.

**How much does Flipp local retailer flyers cost in Cursor?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need an Alexandria account to use Flipp local retailer flyers in Cursor?**

No. Spiral runs Flipp local retailer flyers on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Flipp local retailer flyers in Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while Flipp local retailer flyers runs?**

Flipp local retailer flyers runs in the background. Cursor starts the run, checks on it and gives you the json when it's ready.

**Which countries does Flipp cover?**

Flipp is available in Canada and the United States. Its local ads depend on the shopping ZIP or postal code.

**Does Flipp show every nearby store's weekly ad?**

Some retailers do not have a live ad every week. Flipp also acknowledges that its location matching is imperfect, so a missing ad does not establish that a store has no offers.

**Why do Flipp results change between locations?**

Flipp selects stores using the shopping ZIP or postal code. You can see a different selection of ads by searching the area where you plan to shop.

**Can Flipp show next week's offers?**

Flipp has previews of upcoming flyers, but they are not available for every store. Check the sale period before treating a preview as an offer you can use today.

**Are all displayed Flipp ads still current?**

Flipp acknowledges that expired ads can remain visible, even after refreshing the app. A displayed ad alone does not establish that its offers are still valid.

