Shopfox Shopping

io.github.shopfox-aiPublished by GitHub account shopfox-aiv1.1.1Updated Nov 3, 2026

US shopping research with real prices, sellers, and purchase links from Amazon, Best Buy, Walmart.

VerifiedStreamable HTTPWeb executable

Overview

Shopfox Shopping's hosted MCP server (mcp.shopfox.ai); OAuth sign-in or API key required; Streamable HTTP.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
mcp.shopfox.ai
Last checked

Installation

In SourceWeft

  1. Open Shopfox Shopping in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.shopfox-ai%2Fshopfox-shopping/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "shopfox-shopping": {
      "type": "http",
      "url": "https://mcp.shopfox.ai/mcp"
    }
  }
}

README

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 sayYou 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

bash
codex plugin marketplace add https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin.gitcodex plugin add shopfox-shopping@shopfox-shopping

Then 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

bash
claude plugin marketplace add shopfox-ai/shopfox-shopping-mcp-pluginclaude plugin install shopfox-shopping@shopfox

Claude 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).

Gemini CLI

bash
gemini extensions install https://github.com/shopfox-ai/shopfox-shopping-mcp-plugin

The first time you use it, Gemini CLI opens a Shopfox sign-in page in your browser (OAuth) — no keys to copy. If it doesn't, run /mcp auth shopfox.

Any other MCP client (Cursor, Windsurf, ChatGPT, …)

Add a remote MCP server:

SettingValue
URLhttps://mcp.shopfox.ai/mcp
TransportStreamable HTTP
AuthOAuth (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? [email protected] · GitHub Issues

🛠️ For developers

The plugin is a remote MCP server (Streamable HTTP) at https://mcp.shopfox.ai/mcp.

Layout of this repository

PathPurpose
plugin.json, mcp.jsonPortable Agent Plugins manifest (OpenAI / Codex / ChatGPT), OAuth via dynamic client registration
.codex-plugin/plugin.jsonCompatibility manifest for older Codex builds
.agents/plugins/marketplace.jsonCodex marketplace catalog (install from this repo)
.claude-plugin/plugin.json, .mcp.jsonClaude Code plugin manifest; the API key is collected through userConfig
.claude-plugin/marketplace.jsonClaude Code marketplace catalog (install from this repo)
skills/shopping-advisor/SKILL.mdThe skill that tells the agent how to use the tools
agents/openai.yamlAgent dependency declaration

Authentication

  • OAuth 2.1 with PKCE and dynamic client registration. Discovery: https://mcp.shopfox.ai/.well-known/oauth-authorization-server and https://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

ToolWhen to use
generate_shopping_reportOne-shot full report (local agents, no timeout pressure)
start_shopping_reportAsync report + widget (hosts with short timeouts, e.g. ChatGPT)
research_shopping_optionsStructured options list, supports follow-up questions

Rate limits: 100 requests/day per key, 3 concurrent requests per user.

Validate locally

bash
claude plugin validate --strict .codex plugin marketplace add "$PWD" && codex plugin add shopfox-shopping@shopfox-shopping

License: Apache-2.0

Source: README.md at commit 72f0dbd

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.1.1LatestNov 3, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.