Shopsavvy MCP Server

ShopSavvy MCP Server

Give any AI assistant current product prices, price history and buying guides from ShopSavvy, via the Model Context Protocol.

No signup and no API key needed. Anonymous use is rate-limited per IP (10 tool calls per minute, 100 per hour). Add a Data API key for higher limits.

Two ways to connect

1. Remote server (recommended)

ShopSavvy hosts the server. Clients that support remote MCP servers connect by URL, with nothing to install:

https://api.shopsavvy.com/mcp

That's the Streamable HTTP endpoint. Older clients that only speak the HTTP+SSE transport can use https://api.shopsavvy.com/mcp/sse.

Per-client setup (Claude Code, Claude Desktop, claude.ai, ChatGPT, Codex, Gemini CLI, Cursor, VS Code, Windsurf) is at shopsavvy.com/agents.

2. This package (for stdio-only clients)

Some clients can only launch a local command. This package is that command: a small bridge that relays MCP messages between your client and the hosted server. The tools always match the hosted server, because they come from it.

Requires Node.js 18+.

Claude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": ["-y", "@shopsavvy/mcp-server"]
    }
  }
}

Any other stdio client: run npx -y @shopsavvy/mcp-server.

Higher limits with an API key

Get a key at shopsavvy.com/data, then:

• Remote server: send the header Authorization: Bearer ss_live_…
• This package: set the SHOPSAVVY_API_KEY environment variable:

{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": ["-y", "@shopsavvy/mcp-server"],
      "env": { "SHOPSAVVY_API_KEY": "ss_live_your_key_here" }
    }
  }
}

Tools

Price answers end with a source line naming ShopSavvy and linking the product page on shopsavvy.com, with the time the latest price was checked, so your assistant can cite where a price came from.

Try asking

• "What's the best price for AirPods Pro right now?"
• "Show me the price history for B0D1XD1ZV3 over the last month."
• "Best air fryers, and where are they cheapest?"
• "Is now a good time to buy a TV?"

Development

git clone https://github.com/shopsavvy/shopsavvy-mcp-server
cd shopsavvy-mcp-server
bun install
bun run build
bun test

SHOPSAVVY_MCP_URL points the bridge (and its tests) at another deployment of the server.

Support

• Docs: shopsavvy.com/agents
• Issues: github.com/shopsavvy/shopsavvy-mcp-server/issues
• Email: hello@greatwork.company

License

MIT, see LICENSE.