@reneturcios/martdata 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rene Turcios
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,152 @@
-# Temporary Holding Version
+# martdata
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+martdata is a small local bridge to the hosted HasData
+Walmart MCP server, which returns Walmart storefront
+data as JSON. It can pull one product page in full from
+an item id or URL, page through that product's customer
+reviews, and run keyword or category searches across a
+storefront with price, fulfillment and sort filters.
+
+The bridge holds no product data of its own. It answers
+the tool list locally, exactly as captured from the
+live endpoint, and forwards each tool call upstream,
+returning whatever comes back untouched. The captured
+surface is three read-only fetches over public
+storefront data: there is no cart, checkout, order or
+payment tool in it, and no individual contact data is
+returned.
+
+## Tools
+
+- `hasdata_walmart_product_getWalmartProduct` — fetch
+  one Walmart product in full, by `itemId` or by `url`
+  (the URL wins when both are given). Optional:
+  `domain` (`walmart.com` / `walmart.ca`), `language`
+  (`en` / `es` / `fr`), and `otherOffers` to also
+  collect competing sellers' offers. Returns title,
+  brand, price and availability, the buy-box seller,
+  ratings, variants, fulfillment details and the
+  other-sellers block. No argument is marked required
+  in the captured schema: `itemId` and `url` are
+  alternatives for each other.
+- `hasdata_walmart_reviews_getWalmartReviews` — the
+  customer reviews of one product, ten a page, by
+  `itemId` or `url`. Optional: `domain`, `language`,
+  `page`, `sort` (most relevant, most recent, most
+  helpful, highest or lowest rated, oldest), `rating`
+  (one star value), `aspectId` (one frequent-mention
+  topic), `condition`, and `verifiedPurchasesOnly`.
+  Returns each review with its rating, text, author and
+  vote counts, plus the item's rating breakdown, AI
+  review summary, per-aspect scores and the filters
+  block naming the values later calls can filter by.
+- `hasdata_walmart_search_getSearchResults` — search
+  a storefront by keyword `q`, or browse a category
+  with `catId`, or scrape a full search URL via `url`.
+  Optional: `domain`, `language`, `sort` (best match,
+  price low-to-high or high-to-low, bestseller, highly
+  rated, new arrivals), `page`, `minPrice` and
+  `maxPrice`, `deliveryType` (`shipping` / `pickup`),
+  and `facet` narrowing in `name:value` form. Returns
+  the product list with prices, ratings, sellers and
+  fulfillment details, plus the facets block and
+  pagination.
+
+## Configuration
+
+- `HASDATA_WALMART_MCP_URL` (optional) — override the
+  upstream endpoint. Defaults to
+  `https://mcp.hasdata.com/mcp?apis=walmart`. (The
+  override hook is this rebuild's own labelled
+  reconstruction.)
+- `HASDATA_API_KEY` (optional) — when set, every
+  upstream request carries an `x-api-key: <key>`
+  header, for the caller's own HasData API key. When
+  it is not set, no key header is sent. (The header
+  name and the env name are pinned by the original's
+  registry record; forwarding the key from this env
+  var is a labelled reconstruction — the original
+  surface was captured keyless.)
+
+### Forwarding mechanics
+
+On the first tool call the client opens a streamable
+HTTP session upstream: a JSON-RPC `initialize` request
+(protocolVersion `2025-03-26`, clientInfo name
+`martdata`), then a `notifications/initialized`
+notification, then the `tools/call` request carrying
+the caller's arguments unchanged. When the upstream
+answers `initialize` with an `Mcp-Session-Id` header,
+that value rides on every later request of the
+session, which is reused for the life of the process.
+Replies may arrive as plain JSON or as server-sent
+events; both are read.
+
+Successful upstream results pass through verbatim,
+including any `isError` flag the upstream sets.
+Failures — a JSON-RPC error, a non-2xx status, an
+unreadable response, or a request that cannot be
+completed — come back as an `isError` result whose
+text starts with `martdata error:` (this rendering is
+this rebuild's own labelled reconstruction).
+
+## CLI
+
+Each tool is also a subcommand taking one JSON
+argument string:
+
+```bash
+npx @reneturcios/martdata hasdata_walmart_product_getWalmartProduct '{"itemId":"14977205582"}'
+npx @reneturcios/martdata hasdata_walmart_reviews_getWalmartReviews '{"itemId":"14977205582","sort":"mostRecent"}'
+npx @reneturcios/martdata hasdata_walmart_search_getSearchResults '{"q":"coffee maker","maxPrice":90}'
+npx @reneturcios/martdata --version
+```
+
+Exit codes: `0` on success, `1` on an `isError`
+result, `2` on a usage error.
+
+## MCP server
+
+```bash
+npx -y @reneturcios/martdata mcp
+```
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "martdata": {
+      "command": "npx",
+      "args": ["-y", "@reneturcios/martdata", "mcp"]
+    }
+  }
+}
+```
+
+## Docker
+
+```bash
+docker run -i ghcr.io/cloudcorprecords/martdata
+docker run --rm ghcr.io/cloudcorprecords/martdata --version
+```
+
+The container's default command is `mcp`, so the first
+form is a stdio MCP server; any other arguments reach
+the CLI normally.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run dev
+```
+
+The test suite runs entirely against a stubbed
+JSON-RPC upstream — no live network calls.
+
+## License
+
+MIT — see `LICENSE`.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * martdata CLI.
+ *
+ *   martdata <tool> '<json-args>'
+ *   martdata mcp
+ *   martdata --version
+ *
+ * <tool> is one of the 3 forwarded tools. Each tool
+ * subcommand takes a single JSON argument string holding
+ * that tool's arguments, forwards the call the same way
+ * the MCP path does, and prints the forwarded result
+ * content. Exit codes: 0 success, 1 on an isError
+ * result, 2 usage error.
+ */
+import { callTool, TOOL_NAMES, VERSION } from "./forward.js";
+function usage() {
+    console.error(`Usage:
+  martdata <tool> '<json-args>'     one of: ${TOOL_NAMES.join(", ")}
+  martdata mcp
+  martdata --version`);
+    process.exit(2);
+}
+function firstText(result) {
+    const content = result.content;
+    if (Array.isArray(content)) {
+        for (const item of content) {
+            if (item !== null &&
+                typeof item === "object" &&
+                item.type === "text" &&
+                typeof item.text === "string") {
+                return item.text;
+            }
+        }
+    }
+    return typeof content === "string" ? content : JSON.stringify(content);
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (cmd === "--version" || cmd === "-v") {
+        console.log(VERSION);
+        return;
+    }
+    if (cmd === "mcp") {
+        if (rest.length !== 0)
+            usage();
+        const { startMcpServer } = await import("./mcp.js");
+        await startMcpServer();
+        return;
+    }
+    if (!TOOL_NAMES.includes(cmd ?? ""))
+        usage();
+    if (rest.length > 1)
+        usage();
+    let args = {};
+    if (rest.length === 1) {
+        try {
+            const parsed = JSON.parse(rest[0]);
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                usage();
+            }
+            args = parsed;
+        }
+        catch {
+            console.error("error: argument must be a JSON object string");
+            process.exit(2);
+        }
+    }
+    const result = await callTool(cmd, args);
+    if (result.isError) {
+        console.error(`error: ${firstText(result)}`);
+        process.exit(1);
+    }
+    console.log(typeof result.content === "string"
+        ? result.content
+        : JSON.stringify(result.content, null, 2));
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/forward.d.ts

@@ -0,0 +1,84 @@
+/**
+ * martdata core: a forwarding client for the hosted
+ * HasData Walmart MCP server.
+ *
+ * Nothing is scraped or searched locally. tools/list is
+ * answered from the literal definitions below, taken
+ * verbatim from a live capture of the upstream server
+ * (name, title, description and inputSchema exactly as
+ * captured, title key included, and with NO `required`
+ * key on any inputSchema, exactly as captured). A
+ * tools/call travels upstream over a streamable-HTTP
+ * JSON-RPC session: an initialize POST, a
+ * notifications/initialized POST, then the tools/call
+ * POST, carrying the Mcp-Session-Id response header on
+ * later requests when the upstream issues one. The
+ * session opens lazily on the first forwarded call and
+ * is reused for the client's life.
+ *
+ * The endpoint is pinned to
+ * https://mcp.hasdata.com/mcp?apis=walmart — the query
+ * string belongs to the pinned URL — and may be replaced
+ * with the HASDATA_WALMART_MCP_URL environment variable
+ * (that override is a labelled reconstruction). When
+ * HASDATA_API_KEY is set, every upstream request carries
+ * an `x-api-key: <key>` header (header name pinned by the
+ * registry record's remote declaration; forwarding the
+ * key from this env var is a labelled reconstruction, as
+ * the capture was taken keyless). When it is unset, no
+ * key header goes out, and no Authorization header is
+ * sent in either case.
+ *
+ * A successful upstream result is returned exactly as
+ * received, isError flag and extra fields included.
+ * Failures — an upstream JSON-RPC error, a non-2xx
+ * status, a body that cannot be parsed, or a fetch that
+ * throws or times out — become an isError result whose
+ * text begins with `martdata error:` (that rendering is
+ * a labelled reconstruction). Replies may be plain JSON
+ * or SSE (`data:` lines); the JSON-RPC message whose id
+ * matches the request wins.
+ */
+import type { ForwardDeps, ToolArgs, ToolDef, ToolResult } from "./types.js";
+export declare const VERSION = "0.1.0";
+export declare const DEFAULT_ENDPOINT_URL = "https://mcp.hasdata.com/mcp?apis=walmart";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const PROTOCOL_VERSION = "2025-03-26";
+export declare const TOOL_DEFS: ToolDef[];
+export declare const TOOL_NAMES: string[];
+/** Whether `name` belongs to the captured surface. */
+export declare function isKnownTool(name: string): boolean;
+/**
+ * Read a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * present, otherwise the last parseable message, otherwise
+ * null when nothing in the body parses.
+ */
+export declare function parseRpcBody(text: string, expectedId?: number): Record<string, unknown> | null;
+/**
+ * A forwarding client that holds a single upstream
+ * session, opened lazily on first use and reused from
+ * then on (for the process lifetime in the MCP server,
+ * or for a single invocation in the CLI).
+ */
+export declare class MartdataClient {
+    private readonly deps;
+    private sessionId;
+    private ready;
+    private sessionPromise;
+    private idCounter;
+    constructor(deps?: ForwardDeps);
+    private fetchFn;
+    private endpointUrl;
+    private apiKey;
+    private timeoutMs;
+    private nextId;
+    private post;
+    private ensureSession;
+    /** Forward one tool call; upstream failures come back as isError results. */
+    callTool(name: string, args: ToolArgs): Promise<ToolResult>;
+}
+/** Build a forwarding client; tests inject a fake fetch and env through deps. */
+export declare function createClient(deps?: ForwardDeps): MartdataClient;
+/** One-shot helper: a fresh client for a single call (the CLI path). */
+export declare function callTool(name: string, args: ToolArgs, deps?: ForwardDeps): Promise<ToolResult>;

package/dist/forward.js

@@ -0,0 +1,430 @@
+export const VERSION = "0.1.0";
+export const DEFAULT_ENDPOINT_URL = "https://mcp.hasdata.com/mcp?apis=walmart";
+export const DEFAULT_TIMEOUT_MS = 30000;
+export const PROTOCOL_VERSION = "2025-03-26";
+/* ------------------------------------------------------------------ */
+/* Tool definitions (tools/list literals, verbatim from the live       */
+/* capture in harness/fixtures/hasdata-walmart-tools-original.json)    */
+/* ------------------------------------------------------------------ */
+export const TOOL_DEFS = [
+    {
+        "name": "hasdata_walmart_product_getWalmartProduct",
+        "title": "walmart_product: GET /",
+        "description": "Get Walmart Product Details\n\nScrapes one Walmart product page on a chosen storefront by item id or URL. Returns title, brand, model, UPC, condition, availability, price with strikethrough before-price and unit price, the seller holding the buy box with its rating and return policy, badges, SNAP EBT eligibility, Walmart+ savings, star rating with the per-star review breakdown and AI review summaries, images, category path, highlights, specifications, AI-generated key item features, variant axes with every option and the itemId each combination resolves to, fulfillment details, and the other-sellers block: how many competitors the page advertises always and, when the page shows it, the cheapest competing price, plus - when otherOffers is enabled - the offer list with each seller name, storefront URL, price, condition, shipping cost, delivery date and return policy. Use for price and buy-box monitoring, seller and marketplace competitor tracking, assortment enrichment of item ids harvested from search, and variant mapping.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "itemId": {
+                    "type": "string",
+                    "description": "Walmart item id, taken from a product URL or from the id field of the Walmart Search API response. On `walmart.com` it is numeric (for example `14977205582`), on `walmart.ca` an alphanumeric code (for example `6NZMJ5CW6MH2`). Required unless `url` is provided."
+                },
+                "url": {
+                    "type": "string",
+                    "description": "A full Walmart product URL to scrape as is. When provided, it overrides `itemId` and the storefront is taken from the URL itself. Required unless `itemId` is provided."
+                },
+                "domain": {
+                    "type": "string",
+                    "enum": [
+                        "walmart.com",
+                        "walmart.ca"
+                    ],
+                    "description": "Walmart storefront the item belongs to. Each storefront has its own catalog, item ids, prices and currency, so an id from one storefront does not resolve on another. Ignored when `url` is provided. Default is `walmart.com`."
+                },
+                "language": {
+                    "type": "string",
+                    "enum": [
+                        "en",
+                        "es",
+                        "fr"
+                    ],
+                    "description": "Language of the product details. Availability depends on the storefront - `walmart.com` serves `en` and `es`, `walmart.ca` serves `en` and `fr`. A language the storefront does not support falls back to its default."
+                },
+                "otherOffers": {
+                    "type": "boolean",
+                    "description": "Also collect the offers of other sellers competing for this item - each seller name, storefront, price, condition, shipping cost, delivery date and return policy. This takes an extra request to Walmart and costs 5 credits on top of the base 10, whether or not the item turns out to have competing sellers. How many competitors the item advertises, and the cheapest competing price, are returned in the `otherOffers` block whether the switch is on or off, so it can be left off until the count shows there is something to collect. Default is `false`."
+                }
+            },
+            "additionalProperties": false,
+            "$schema": "http://json-schema.org/draft-07/schema#"
+        }
+    },
+    {
+        "name": "hasdata_walmart_reviews_getWalmartReviews",
+        "title": "walmart_reviews: GET /",
+        "description": "Get Walmart Product Reviews\n\nScrapes the customer reviews of one Walmart product on a chosen storefront by item id or URL, ten reviews a page. Returns each review with its rating, title, full text with paragraphs preserved, submission date, author, verified-purchase flag, helpful and not-helpful vote counts, badges, marketplace seller, photos and videos, and the review aspects it was tagged with. Alongside the reviews it returns the item rating, how many ratings versus how many written reviews exist, the per-star breakdown, the AI review summary, per-aspect scores such as Quality or Value for money, and a filters block listing exactly which star ratings, frequent mentions and conditions this item can be filtered by, with a count for each - the values in that block are the ones to pass back as request parameters. Sort by most relevant, most recent, most helpful, highest rated, lowest rated or oldest, and filter by star rating, frequent mention, condition or verified purchases only. Use for review mining and sentiment analysis, tracking what buyers praise or complain about per product, monitoring new reviews over time, and pulling only verified-purchase feedback.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "itemId": {
+                    "type": "string",
+                    "description": "Walmart item id, taken from a product URL or from the id field of the Walmart Search API response. On `walmart.com` it is numeric (for example `14977205582`), on `walmart.ca` an alphanumeric code (for example `6NZMJ5CW6MH2`). Required unless `url` is provided."
+                },
+                "url": {
+                    "type": "string",
+                    "description": "A full Walmart product URL whose reviews to scrape. When provided, it overrides `itemId` and the storefront is taken from the URL itself. Required unless `itemId` is provided."
+                },
+                "domain": {
+                    "type": "string",
+                    "enum": [
+                        "walmart.com",
+                        "walmart.ca"
+                    ],
+                    "description": "Walmart storefront the item belongs to. Each storefront has its own catalog, item ids and review pool, so an id from one storefront does not resolve on another. Ignored when `url` is provided. Default is `walmart.com`."
+                },
+                "language": {
+                    "type": "string",
+                    "enum": [
+                        "en",
+                        "es",
+                        "fr"
+                    ],
+                    "description": "Language of the review page. Availability depends on the storefront - `walmart.com` serves `en` and `es`, `walmart.ca` serves `en` and `fr`. A language the storefront does not support falls back to its default. Reviews themselves are returned in the language their author wrote them in."
+                },
+                "page": {
+                    "type": "number",
+                    "description": "Page of reviews to return, ten reviews a page. The response reports the last available page in `pagination.totalPages`, the next one in `pagination.nextPage`, and how many reviews the current filters select in `pagination.totalResults`. Note that only reviews carrying written text are paginated, so the ceiling follows `reviewsInformation.totalReviews` rather than the larger `reviewsInformation.totalRatings`. Default is `1`."
+                },
+                "sort": {
+                    "type": "string",
+                    "enum": [
+                        "mostRelevant",
+                        "mostRecent",
+                        "mostHelpful",
+                        "highestRated",
+                        "lowestRated",
+                        "oldest"
+                    ],
+                    "description": "Order of the returned reviews, named as the Walmart review page names it. Default is `mostRelevant`."
+                },
+                "rating": {
+                    "type": "number",
+                    "description": "Return only reviews carrying this star rating, from `1` to `5`. The Star rating group of the `filters` block lists the ratings this item actually has, each with the `value` to send here and a `count` of how many reviews to expect."
+                },
+                "aspectId": {
+                    "type": "string",
+                    "description": "Return only reviews mentioning one topic. Send the `value` of the topic you want, taken from the Frequent mentions group of the `filters` block in the response - given `{\"name\": \"Battery Life\", \"value\": \"6049\", \"count\": 8}` you send `6049`, and `count` is how many reviews to expect. **Only one topic per request**, Walmart rejects a list of them. Topics belong to the product rather than to Walmart: a phone offers Battery Life or Display, a coffee offers Flavor or Aroma, and some items offer none at all - so make an unfiltered request first and read the block, instead of reusing a topic id across products."
+                },
+                "condition": {
+                    "type": "string",
+                    "description": "Return only reviews written about one condition of the item. Send the `value` from the Condition group of the `filters` block - given `{\"name\": \"Restored: Like New\", \"value\": \"5\"}` you send `5`. **Only one condition per request.** This group appears for items Walmart sells in several conditions, and only when the request already names one: reach the variant through the `url` parameter with its `conditionGroupCode`, as in `https://www.walmart.com/ip/1028936148?conditionGroupCode=2`, and the block then lists the condition that variant carries. An item sold in a single condition has no such group, and no reviews to separate by it."
+                },
+                "verifiedPurchasesOnly": {
+                    "type": "boolean",
+                    "description": "Return only reviews left by customers whose purchase Walmart confirmed. Narrows the pool considerably, since most reviews are unverified or syndicated from the manufacturer."
+                }
+            },
+            "additionalProperties": false,
+            "$schema": "http://json-schema.org/draft-07/schema#"
+        }
+    },
+    {
+        "name": "hasdata_walmart_search_getSearchResults",
+        "title": "walmart_search: GET /",
+        "description": "Get Walmart Search Results\n\nRuns a keyword or category search on a chosen Walmart storefront with pagination, price range and fulfillment filters, facet narrowing, and sort order (best match, price low-to-high, price high-to-low, bestseller, highly rated, new arrivals). Returns the product list with item id, title, product URL, brand, price and strikethrough before-price, star rating, review count, seller, availability, sponsored flag, badges, SNAP EBT eligibility, Walmart+ savings, variants, other offers and fulfillment details (shipping, pickup, delivery messages), plus the facets block listing every filter the query supports with the exact value to send back in the facet parameter, pagination, and the store the prices belong to. Use for SERP monitoring, price and assortment tracking, share-of-shelf analysis, competitor discovery, and harvesting item ids to feed downstream product or reviews endpoints.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "q": {
+                    "type": "string",
+                    "description": "The search term for which to get the search results. It can be omitted only when `catId` is provided, to browse a whole category instead of searching."
+                },
+                "catId": {
+                    "type": "string",
+                    "description": "Walmart category id, taken from a category URL (for example `976759_1086446_1229651`). Combine it with `q` to search inside a category, or send it alone to browse the whole category. Required unless `q` is provided."
+                },
+                "domain": {
+                    "type": "string",
+                    "enum": [
+                        "walmart.com",
+                        "walmart.ca"
+                    ],
+                    "description": "Walmart storefront to search. Each storefront has its own catalog, prices and currency. Default is `walmart.com`."
+                },
+                "language": {
+                    "type": "string",
+                    "enum": [
+                        "en",
+                        "es",
+                        "fr"
+                    ],
+                    "description": "Language of the results. Availability depends on the storefront - `walmart.com` serves `en` and `es`, `walmart.ca` serves `en` and `fr`. A language the storefront does not support falls back to its default."
+                },
+                "sort": {
+                    "type": "string",
+                    "enum": [
+                        "bestMatch",
+                        "priceLowToHigh",
+                        "priceHighToLow",
+                        "bestseller",
+                        "highlyRated",
+                        "newArrivals"
+                    ],
+                    "description": "The sorting option for the search results."
+                },
+                "url": {
+                    "type": "string",
+                    "description": "A full Walmart search or category URL to scrape as is. When provided, it overrides `q`, `catId` and the other search parameters, and the storefront is taken from the URL itself."
+                },
+                "page": {
+                    "type": "number",
+                    "description": "Page number for pagination (e.g., `1` for the first page, `2` for the second page, etc.). Walmart stops serving results after roughly page 10, returning an empty page beyond that."
+                },
+                "minPrice": {
+                    "type": "number",
+                    "description": "Lower bound of the price range, in the storefront currency."
+                },
+                "maxPrice": {
+                    "type": "number",
+                    "description": "Upper bound of the price range, in the storefront currency."
+                },
+                "deliveryType": {
+                    "type": "string",
+                    "enum": [
+                        "shipping",
+                        "pickup"
+                    ],
+                    "description": "Keep only the products available with the selected fulfillment method. Default is `shipping`. Note that `pickup` is answered against one Walmart store, so an item in stock nationally can still be unavailable for `pickup` nearby - the response then reports that nothing matched the filters rather than that the query had no results."
+                },
+                "facet": {
+                    "type": "string",
+                    "description": "Walmart filter in the `name:value` form, for example `brand:Great Value`. Every value available for a query is listed in the facets block of the response, each one carrying the exact string to send back here, so a first unfiltered request tells you what can be filtered on. To combine filters, put each one on its own line. The double-pipe form Walmart's own urls use `brand:Great Value||retailer_type:Walmart` is also accepted."
+                }
+            },
+            "additionalProperties": false,
+            "$schema": "http://json-schema.org/draft-07/schema#"
+        }
+    }
+];
+export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
+/** Whether `name` belongs to the captured surface. */
+export function isKnownTool(name) {
+    return TOOL_NAMES.includes(name);
+}
+/* ------------------------------------------------------------------ */
+/* Forwarding client                                                   */
+/* ------------------------------------------------------------------ */
+function errorResult(detail) {
+    return {
+        content: [{ type: "text", text: `martdata error: ${detail}` }],
+        isError: true,
+    };
+}
+function rpcErrorMessage(error) {
+    if (error !== null && typeof error === "object") {
+        const message = error.message;
+        if (typeof message === "string" && message !== "")
+            return message;
+        return JSON.stringify(error);
+    }
+    return String(error);
+}
+/**
+ * Read a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * present, otherwise the last parseable message, otherwise
+ * null when nothing in the body parses.
+ */
+export function parseRpcBody(text, expectedId) {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return null;
+    const candidates = [];
+    const tryPush = (payload) => {
+        try {
+            const parsed = JSON.parse(payload);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                candidates.push(parsed);
+            }
+        }
+        catch {
+            // Not a JSON payload; skip this candidate.
+        }
+    };
+    if (trimmed.includes("data:")) {
+        for (const line of trimmed.split("\n")) {
+            const t = line.trim();
+            if (!t.startsWith("data:"))
+                continue;
+            const payload = t.slice("data:".length).trim();
+            if (payload !== "" && payload !== "[DONE]")
+                tryPush(payload);
+        }
+    }
+    else {
+        tryPush(trimmed);
+    }
+    if (candidates.length === 0)
+        return null;
+    if (expectedId !== undefined) {
+        const match = candidates.find((c) => c.id === expectedId);
+        if (match !== undefined)
+            return match;
+    }
+    return candidates[candidates.length - 1];
+}
+async function defaultFetch(url, init) {
+    return fetch(url, init);
+}
+/**
+ * A forwarding client that holds a single upstream
+ * session, opened lazily on first use and reused from
+ * then on (for the process lifetime in the MCP server,
+ * or for a single invocation in the CLI).
+ */
+export class MartdataClient {
+    deps;
+    sessionId = null;
+    ready = false;
+    sessionPromise = null;
+    idCounter = 0;
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    fetchFn() {
+        return this.deps.fetchFn ?? defaultFetch;
+    }
+    endpointUrl() {
+        if (this.deps.url && this.deps.url.trim() !== "")
+            return this.deps.url.trim();
+        const raw = (this.deps.env ?? process.env).HASDATA_WALMART_MCP_URL;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return DEFAULT_ENDPOINT_URL;
+    }
+    apiKey() {
+        const raw = (this.deps.env ?? process.env).HASDATA_API_KEY;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return null;
+    }
+    timeoutMs() {
+        if (typeof this.deps.timeoutMs === "number" && this.deps.timeoutMs > 0) {
+            return this.deps.timeoutMs;
+        }
+        return DEFAULT_TIMEOUT_MS;
+    }
+    nextId() {
+        this.idCounter += 1;
+        return this.idCounter;
+    }
+    async post(body, withSession) {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+        };
+        const key = this.apiKey();
+        if (key !== null)
+            headers["x-api-key"] = key;
+        if (withSession && this.sessionId !== null) {
+            headers["Mcp-Session-Id"] = this.sessionId;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs());
+        try {
+            return await this.fetchFn()(this.endpointUrl(), {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async ensureSession() {
+        if (this.ready)
+            return;
+        if (this.sessionPromise === null) {
+            this.sessionPromise = (async () => {
+                const initId = this.nextId();
+                const initRes = await this.post({
+                    jsonrpc: "2.0",
+                    id: initId,
+                    method: "initialize",
+                    params: {
+                        protocolVersion: PROTOCOL_VERSION,
+                        capabilities: {},
+                        clientInfo: { name: "martdata", version: VERSION },
+                    },
+                }, false);
+                const sessionId = initRes.headers.get("mcp-session-id");
+                if (sessionId)
+                    this.sessionId = sessionId;
+                const initText = await initRes.text();
+                const initParsed = parseRpcBody(initText, initId);
+                if (initParsed !== null && initParsed.error) {
+                    throw new Error(rpcErrorMessage(initParsed.error));
+                }
+                if (initRes.status < 200 || initRes.status >= 300) {
+                    throw new Error(`HTTP ${initRes.status}`);
+                }
+                if (initParsed === null && initText.trim() !== "") {
+                    throw new Error("malformed response");
+                }
+                const initializedRes = await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, true);
+                try {
+                    await initializedRes.text();
+                }
+                catch {
+                    // Nothing needed from the notification response body.
+                }
+                this.ready = true;
+            })();
+        }
+        try {
+            await this.sessionPromise;
+        }
+        catch (err) {
+            this.sessionPromise = null;
+            this.sessionId = null;
+            throw err;
+        }
+    }
+    /** Forward one tool call; upstream failures come back as isError results. */
+    async callTool(name, args) {
+        try {
+            await this.ensureSession();
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+        const callId = this.nextId();
+        let callRes;
+        try {
+            callRes = await this.post({
+                jsonrpc: "2.0",
+                id: callId,
+                method: "tools/call",
+                params: { name, arguments: args ?? {} },
+            }, true);
+        }
+        catch (err) {
+            return errorResult(`request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const parsed = parseRpcBody(await callRes.text(), callId);
+        if (parsed !== null && parsed.error) {
+            return errorResult(rpcErrorMessage(parsed.error));
+        }
+        if (callRes.status < 200 || callRes.status >= 300) {
+            return errorResult(`HTTP ${callRes.status}`);
+        }
+        if (parsed === null)
+            return errorResult("malformed response");
+        const result = parsed.result;
+        if (result === undefined || result === null || typeof result !== "object") {
+            return errorResult("malformed response");
+        }
+        // Hand the upstream result back exactly as received.
+        return result;
+    }
+}
+/** Build a forwarding client; tests inject a fake fetch and env through deps. */
+export function createClient(deps = {}) {
+    return new MartdataClient(deps);
+}
+/** One-shot helper: a fresh client for a single call (the CLI path). */
+export async function callTool(name, args, deps = {}) {
+    return new MartdataClient(deps).callTool(name, args);
+}
+//# sourceMappingURL=forward.js.map

package/dist/forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./forward.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./forward.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,33 @@
+/**
+ * martdata MCP server. Tools: the 3 captured HasData
+ * Walmart tools (see forward.ts).
+ *
+ * This file uses the low-level Server API rather than
+ * McpServer: the high-level helper rebuilds schemas from
+ * zod and rewrites what is served, which would break
+ * exact parity with the captured tools/list. Here
+ * tools/list is answered locally from the core's literal
+ * definitions — the verbatim objects from the upstream
+ * capture — and every tools/call is forwarded upstream.
+ *
+ * A forwarded result returns unchanged, upstream isError
+ * flag and extra fields included. An upstream failure
+ * arrives as an isError result carrying a
+ * `martdata error:` text, built by the forwarding
+ * client. Unknown tool names are rejected with McpError
+ * MethodNotFound, and non-object arguments with McpError
+ * InvalidParams, before any network hop is made.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type MartdataClient } from "./forward.js";
+import type { ForwardDeps, ToolResult } from "./types.js";
+/**
+ * Validate and forward a single tools/call through
+ * `client`. Exported so this layer can be tested directly
+ * without a stdio transport.
+ */
+export declare function handleCallTool(client: MartdataClient, name: string, args: unknown): Promise<ToolResult>;
+/** Build the stdio MCP server (transport not yet connected). */
+export declare function createServer(deps?: ForwardDeps): Server;
+/** Connect the MCP server over stdio. */
+export declare function startMcpServer(deps?: ForwardDeps): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,58 @@
+/**
+ * martdata MCP server. Tools: the 3 captured HasData
+ * Walmart tools (see forward.ts).
+ *
+ * This file uses the low-level Server API rather than
+ * McpServer: the high-level helper rebuilds schemas from
+ * zod and rewrites what is served, which would break
+ * exact parity with the captured tools/list. Here
+ * tools/list is answered locally from the core's literal
+ * definitions — the verbatim objects from the upstream
+ * capture — and every tools/call is forwarded upstream.
+ *
+ * A forwarded result returns unchanged, upstream isError
+ * flag and extra fields included. An upstream failure
+ * arrives as an isError result carrying a
+ * `martdata error:` text, built by the forwarding
+ * client. Unknown tool names are rejected with McpError
+ * MethodNotFound, and non-object arguments with McpError
+ * InvalidParams, before any network hop is made.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { createClient, isKnownTool, TOOL_DEFS, VERSION, } from "./forward.js";
+/**
+ * Validate and forward a single tools/call through
+ * `client`. Exported so this layer can be tested directly
+ * without a stdio transport.
+ */
+export async function handleCallTool(client, name, args) {
+    if (!isKnownTool(name)) {
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    if (args !== undefined &&
+        (typeof args !== "object" || args === null || Array.isArray(args))) {
+        throw new McpError(ErrorCode.InvalidParams, `Arguments for tool ${name} must be a JSON object`);
+    }
+    return client.callTool(name, (args ?? {}));
+}
+/** Build the stdio MCP server (transport not yet connected). */
+export function createServer(deps = {}) {
+    const client = createClient(deps);
+    const server = new Server({ name: "martdata", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const result = await handleCallTool(client, name, args);
+        return result;
+    });
+    return server;
+}
+/** Connect the MCP server over stdio. */
+export async function startMcpServer(deps = {}) {
+    await createServer(deps).connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,OAAO,GAER,MAAM,cAAc,CAAC;AAGtB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,IAAY,EACZ,IAAa;IAEb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IACE,IAAI,KAAK,SAAS;QAClB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,sBAAsB,IAAI,wBAAwB,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;AACxE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE;IACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,MAAe,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAoB,EAAE;IACzD,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * martdata types.
+ *
+ * This package keeps no product data locally. It is a forwarding
+ * client: the captured tool surface is held as data (ToolDef
+ * entries served verbatim for tools/list) and each tools/call
+ * is sent to the hosted HasData Walmart MCP endpoint via an
+ * injectable fetch, so tests can run with no live network.
+ */
+/** One captured tool definition, served exactly as captured for tools/list. */
+export interface ToolDef {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** Arguments for a tool call, as decoded JSON. */
+export type ToolArgs = Record<string, unknown>;
+/** A tools/call result: upstream payloads pass through verbatim; local failures use this shape too. */
+export interface ToolResult {
+    content?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/** The narrow part of a fetch Response the forwarding client depends on. */
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}
+/** Injectable fetch function, so tests never reach the live network. */
+export type FetchFn = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<FetchResponseLike>;
+/** Injectable runtime dependencies for the forwarding client. */
+export interface ForwardDeps {
+    /** Fetch implementation. Defaults to the global fetch. */
+    fetchFn?: FetchFn;
+    /** Environment (HASDATA_WALMART_MCP_URL, HASDATA_API_KEY). Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Endpoint URL override. Defaults to env HASDATA_WALMART_MCP_URL or the pinned default. */
+    url?: string;
+    /** Per-request timeout in milliseconds. Defaults to 30000. */
+    timeoutMs?: number;
+}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * martdata types.
+ *
+ * This package keeps no product data locally. It is a forwarding
+ * client: the captured tool surface is held as data (ToolDef
+ * entries served verbatim for tools/list) and each tools/call
+ * is sent to the hosted HasData Walmart MCP endpoint via an
+ * injectable fetch, so tests can run with no live network.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -1,6 +1,41 @@
 {
+  "bin": {
+    "martdata": "dist/cli.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1",
+    "zod": "^4"
+  },
+  "description": "Walmart data as JSON from your agent: a local bridge to the hosted HasData Walmart MCP service that fetches one product page in full, pulls that product's customer reviews page by page, and runs storefront searches with price, fulfillment and sort filters, returning everything exactly as the upstream service sends it. One bin serves a small CLI and a stdio MCP server.",
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "server.json"
+  ],
+  "homepage": "https://github.com/CloudCorpRecords/martdata#readme",
+  "license": "MIT",
+  "mcpName": "io.github.CloudCorpRecords/martdata",
   "name": "@reneturcios/martdata",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CloudCorpRecords/martdata.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "tsx --test test/*.test.ts"
+  },
+  "type": "module",
+  "version": "0.1.0"
+}

package/server.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "description": "Walmart data as JSON: product details, customer reviews, and storefront search with filters.",
+  "name": "io.github.CloudCorpRecords/martdata",
+  "packages": [
+    {
+      "identifier": "@reneturcios/martdata",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "registryType": "npm",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "version": "0.1.0"
+    },
+    {
+      "identifier": "ghcr.io/cloudcorprecords/martdata:0.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "registryType": "oci",
+      "runtimeArguments": [
+        {
+          "name": "--rm",
+          "type": "named"
+        },
+        {
+          "name": "-i",
+          "type": "named"
+        }
+      ],
+      "runtimeHint": "docker",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "repository": {
+    "source": "github",
+    "url": "https://github.com/CloudCorpRecords/martdata"
+  },
+  "version": "0.1.0"
+}