Shelfscout

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 16, 2026

Hobby price and stock checks, consumer recall search, card-grading guidance, settlements.

VerifiedSTDIODesktop onlyFinance

Overview

Shelfscout's local MCP server; no sign-in required; STDIO; 5 tools.

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

Installation

In SourceWeft

  1. Open Shelfscout in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

shelfscout

Is that Pokémon box actually overpriced, has the sold-out LEGO set restocked anywhere, and has the stroller you are about to recommend been recalled? shelfscout is a local forwarding client for a hosted oracle service that answers exactly those kinds of questions about hobby products and consumer goods: it answers tools/list locally from the captured tool definitions and forwards every call to the service, returning the answers exactly as the service sends them back.

Every read here is about a product, never a person. The price check compares an asking price against current retail and returns a fair / high / scalped verdict — a read about a product's price, not a transaction; nothing is bought. The stock check returns recent restock matches with buy links, and links only: this client executes no purchase. The recall search runs over published CPSC, FDA and NHTSA recall registers. The settlements search surfaces published class-action settlements with their claim details; this client files no claim and submits nothing.

All 5 captured tools are built; there are no omissions.

The tools

  • check_scalper_price — Checks whether a hobby item's asking price is fair or scalped, comparing it against current retail across tracked specialty shops for the niche. Returns a verdict (fair / high / scalped), the retail price band, and where to buy at retail. niche (one of tcg, lego, funko, keebs, vinyl, aqua) and query are required; price is the optional asking price you are seeing.
  • check_recall — Searches active consumer product recalls (CPSC, FDA, NHTSA and more) by keyword. Returns matching recalls with agency, hazard, affected products, and remedy. query is required.
  • check_in_stock — Checks whether a hobby item has recently dropped or restocked across the specialty shops monitored for a niche. Returns recent in-stock matches (new and restock) with direct buy links. niche and query are required.
  • grade_card_centering — Card-centering guidance. The centering measurement itself runs client-side in the browser on the uploaded image and is not server-callable; this tool returns guidance plus a link to the live CardGrade tool where the analysis runs. image_url is optional, and the captured schema carries an empty required list, served verbatim.
  • find_settlements — Finds open class-action settlements you may be eligible to claim, often with no proof of purchase required. Returns settlements with payout, claim deadline, proof requirements, and the official claim URL. query is an optional filter; the captured schema carries an empty required list, served verbatim.

Install and run

As an MCP server via npm:

bash
npx -y @reneturcios/shelfscout mcp

MCP client configuration:

json
{  "mcpServers": {    "shelfscout": {      "command": "npx",      "args": ["-y", "@reneturcios/shelfscout", "mcp"]    }  }}

As a container:

bash
docker run -i ghcr.io/cloudcorprecords/shelfscoutdocker run --rm ghcr.io/cloudcorprecords/shelfscout check_recall '{"query":"stroller"}'

CLI

One binary serves both the command line and the MCP server. Each tool is a subcommand taking a single JSON string with that tool's arguments:

bash
shelfscout check_scalper_price '{"niche":"tcg","query":"Pokemon 151 Booster Box","price":289}'shelfscout check_recall '{"query":"infant formula"}'shelfscout check_in_stock '{"niche":"lego","query":"Millennium Falcon"}'shelfscout find_settlements '{"query":"data breach"}'shelfscout --version

Exit codes: 0 when the forwarded call succeeds, 1 when the upstream result is an error, and 2 for usage problems such as an unknown subcommand or a malformed JSON argument.

Configuration

  • ORACLE_MCP_URL — Overrides the upstream endpoint. The default is the pinned hosted endpoint, https://oracle.dropwatchhq.com/mcp. (The override variable is a reconstruction added by this rebuild.)

The upstream registry record declares no headers, so no authentication header is ever sent; the tool surface was captured keyless.

Upstream failures — a JSON-RPC error from the service, a non-2xx response, an unreadable body, or a request that fails outright — are reported to the caller as an error result whose text starts with shelfscout error:.

How forwarding works

The first forwarded call opens a session: an initialize request (protocol version 2025-03-26), followed by a notifications/initialized notification, then the tools/call itself. If the service answers the initialize request with an Mcp-Session-Id header, that value is carried on every later request, and the open session is reused for the rest of the process. Replies are accepted either as plain JSON or as server-sent events. Successful results pass through verbatim, including any isError flag and any extra fields the service includes.

Development

bash
npm installnpm run build   # tsc -> dist/ (dist/cli.js is the bin)npm test        # tsx --test test/*.test.ts — stubbed upstream, no networknpm run dev     # run the CLI from source

The test suite checks the served tool list against the captured surface (all 5 tools, deep-equal, in order, with no titles invented and the two empty required arrays preserved exactly), exercises the session handshake and its reuse, verifies that no Authorization header is ever sent under any environment, and verifies that arguments go upstream untouched and results come back untouched.

License

MIT — see LICENSE. Copyright (c) 2026 Rene Turcios.

Source: README.md at commit c68321a

Tools

5

check_scalper_price

Check whether a hobby item's asking price is fair or scalped. Compares a price you're seeing against current retail across tracked specialty shops for the niche. Returns a verdict (fair/high/scalped), the retail price band, and where to buy at retail. Use when an agent or user wants to know if a Pokémon box, LEGO set, Funko, keyboard, vinyl, or aquarium item is overpriced.

Parametersnicherequiredpricequeryrequired

check_recall

Search active consumer product recalls (CPSC, FDA, NHTSA and more) by keyword. Returns matching recalls with agency, hazard, affected products, and remedy. Use when an agent needs to know if a product, brand, baby/food/vehicle item has been recalled before recommending or buying it.

Parametersqueryrequired

check_in_stock

Check whether a hobby item has recently dropped or restocked across the specialty shops we monitor for a niche. Returns recent in-stock matches (new + restock) with direct buy links. Use when an agent wants to find where a sold-out collectible is currently available.

Parametersnicherequiredqueryrequired

grade_card_centering

Estimate a trading card's centering and rough PSA-style grade from a photo. NOTE: the centering measurement runs client-side in the browser (computer vision on the uploaded image) and is not server-callable here. This tool returns guidance plus a link to the live CardGrade tool where the agent or user can run the analysis.

Parametersimage_url

find_settlements

Find open class-action settlements you may be eligible to claim (often no proof of purchase required). Returns settlements with payout, claim deadline, proof requirements, and the official claim URL. Use when an agent wants to surface free-money / consumer-rights opportunities for a user.

Parametersquery

Version history

1
  1. v0.1.0LatestNov 16, 2026

Score

90% 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 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts