Shopfox Shopping
US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http shopfox-shopping 'https://mcp.shopfox.ai/mcp' --header 'Authorization: <Optional. '\''Bearer sk_shopfox_...'\'' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>'{
"mcpServers": {
"shopfox-shopping": {
"type": "http",
"url": "https://mcp.shopfox.ai/mcp",
"headers": {
"Authorization": "<Optional. 'Bearer sk_shopfox_...' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Shopfox Shopping
Ask your AI to shop for you — get real prices, real stores, real links.
Shopfox turns any AI assistant into a shopping expert. Ask in plain English, and it researches live offers across Amazon, Best Buy, Walmart, and Target — then delivers a complete report: 3–5 top picks with current prices, ratings, pros & cons, and direct purchase links. No more guessing, no more tab-hopping.
✨ What you can ask
| You say | You get |
|---|---|
| "Find noise-cancelling headphones under $200" | Top 5 picks, prices, links |
| "Birthday gift for a photographer, budget $200" | Thoughtful picks for their use case |
| "55-inch TV for a bright living room, under $800" | Recommendations matched to your room |
| "Compare gaming laptops around $1000, $1500, $2000" | Side-by-side picks at each budget |
| "I prefer Apple accessories, now find me earbuds under $180" | Recommendations that remember you |
🚀 Install
Codex
codex plugin marketplace add https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin.git
codex plugin add shopfox-shopping@shopfox-shoppingThen type @shopfox in Codex. The first time you use it, Codex opens a Shopfox
sign-in page in your browser (OAuth) — no keys to copy.
Claude Code
claude plugin marketplace add shopfox-ai/shopfox-shopping-mcp-plugin
claude plugin install shopfox-shopping@shopfoxClaude Code asks for your Shopfox API key when it enables the plugin. Get one in one click at https://www.shopfox.ai/user-info?createApiKey=1 (sign in or sign up, the key is created automatically and shown once).
Any other MCP client (Cursor, Windsurf, ChatGPT, …)
Add a remote MCP server:
| Setting | Value |
|---|---|
| URL | https://mcp.shopfox.ai/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth (automatic), or Authorization: Bearer sk_shopfox_… with a key from the link above |
Then ask your first question:
"Find me noise-cancelling headphones under $200"
📖 What happens next
Your AI will return a complete shopping report — don't settle for less:
- 3–5 specific products, each with:
- Real current price and the store that has it
- A direct purchase link
- Why it's worth it (and what to watch out for)
- A clear recommendation for your budget and use case
A full report takes a few minutes to research. The full report is the answer. If your AI tries to summarize it into one pick or just hands you a link, ask it to show you the whole report.
🔒 Your privacy
- Your sign-in or key is stored on your device and only sent to shopfox.ai
- Searches are processed server-side and not stored long-term
- Your preferences are private to your account
- Privacy policy · Terms of service
❓ Frequently asked
Is it free? Yes — sign up in one click, no card required.
What can it shop for? Anything sold on major US retailers (Amazon, Best Buy, Walmart, Target): electronics, home goods, gifts, and more.
Does it buy things for me? No — it researches and compares, you buy. We give you the best price and the link; checkout happens on the retailer's site.
Can it remember my taste? Yes — tell it your preferences once and it carries them across conversations.
Need help? support@shopfox.ai · GitHub Issues
🛠️ For developers
The plugin is a remote MCP server (Streamable HTTP) at https://mcp.shopfox.ai/mcp.
Layout of this repository
| Path | Purpose |
|---|---|
plugin.json, mcp.json | Portable Agent Plugins manifest (OpenAI / Codex / ChatGPT), OAuth via dynamic client registration |
.codex-plugin/plugin.json | Compatibility manifest for older Codex builds |
.agents/plugins/marketplace.json | Codex marketplace catalog (install from this repo) |
.claude-plugin/plugin.json, .mcp.json | Claude Code plugin manifest; the API key is collected through userConfig |
.claude-plugin/marketplace.json | Claude Code marketplace catalog (install from this repo) |
skills/shopping-advisor/SKILL.md | The skill that tells the agent how to use the tools |
agents/openai.yaml | Agent dependency declaration |
Authentication
- OAuth 2.1 with PKCE and dynamic client registration. Discovery:
https://mcp.shopfox.ai/.well-known/oauth-authorization-serverandhttps://mcp.shopfox.ai/.well-known/oauth-protected-resource. Scope:mcp:shopping. - Or a personal API key as a bearer token:
Authorization: Bearer sk_shopfox_…, created at https://www.shopfox.ai/user-info?createApiKey=1 (or Settings → Agent API in the Shopfox web app).
Tools
| Tool | When to use |
|---|---|
generate_shopping_report | One-shot full report (local agents, no timeout pressure) |
start_shopping_report | Async report + widget (hosts with short timeouts, e.g. ChatGPT) |
research_shopping_options | Structured options list, supports follow-up questions |
Rate limits: 100 requests/day per key, 3 concurrent requests per user.
Validate locally
claude plugin validate --strict .
codex plugin marketplace add "$PWD" && codex plugin add shopfox-shopping@shopfox-shoppingLicense: Apache-2.0
Frequently asked questions
What is Shopfox Shopping?
US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.
How do I install Shopfox Shopping?
It runs as a remote server. In Claude Code: claude mcp add --transport http shopfox-shopping 'https://mcp.shopfox.ai/mcp' --header 'Authorization: <Optional. '\''Bearer sk_shopfox_...'\'' personal key from https://www.shopfox.ai/user-info?createApiKey=1. Leave empty to sign in with OAuth instead.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Shopfox Shopping need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Shopfox Shopping open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Shopfox Shopping?
It is published by shopfox-ai. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.