@scavio/mcp-server 0.13.1 → 0.14.0

package/dist/tools/tripadvisor.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 // No zod `.default()` anywhere in this file, on purpose. The MCP SDK applies a
 // zod default BEFORE the handler runs, so a defaulted field is posted on every
 // single call whether the model set it or not — which is exactly how the
@@ -7,93 +8,69 @@ import { handleApiError } from "../lib/tool-error.js";
 // Upstream defaults are documented in the .describe() text instead and left for
 // the backend to apply.
 const geoIdField = () => z.string().min(1).max(500).optional()
-    .describe("Tripadvisor geo id — the 'g' half of the g/d pair every Tripadvisor URL is keyed by. Accepts '30196', 'g30196', or any tripadvisor.com URL carrying one. Get it from resolve_tripadvisor_location.");
+    .describe("Geo id, e.g. '30196' or 'g30196'. Get from resolve_tripadvisor_location.");
 const categoryField = () => z.enum(["restaurants", "hotels", "attractions"]).optional()
-    .describe("Which of Tripadvisor's three location families to read. These are separate URL families, not a filter — they are not interchangeable. Upstream default is 'restaurants'.");
+    .describe("Location family (default 'restaurants'). Separate URL families, not a filter.");
 export function registerTripadvisorTools(server, getClient) {
-    server.tool("resolve_tripadvisor_location", `START HERE for Tripadvisor. Resolves a place or business NAME to the Tripadvisor ids every other Tripadvisor tool is keyed by, as JSON.
-
-Each row is either a GEO (a city, region or other destination — its geo_id is what search_tripadvisor takes) or a BUSINESS (a restaurant, hotel or attraction — its geo_id + location_id PAIR is what get_tripadvisor_location and get_tripadvisor_reviews take). Rows also carry the display name, type, and parent geography so you can pick the right "Springfield".
-
-Call this first whenever you only have a name. Those ids exist nowhere except inside Tripadvisor's own URLs, so there is no other entry point into this platform.
-
-limit only SIZES this response (1-20, upstream default 12) — it is not a page parameter and this lookup has no pagination. Costs 2 credits.`, {
+    server.tool("resolve_tripadvisor_location", `Resolve a place or business name to Tripadvisor ids (geo_id, location_id). Start here before other Tripadvisor tools. 2 credits.`, {
         query: z.string().min(1).max(120)
-            .describe("A place or business name to resolve, e.g. 'Austin' or 'Franklin Barbecue'."),
+            .describe("Place or business name."),
         limit: z.number().int().min(1).max(20).optional()
-            .describe("Rows to return, 1-20. Upstream default is 12. Sizes the response only — NOT a page parameter."),
+            .describe("Rows (default 12). Not paginated."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/tripadvisor/locations", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("search_tripadvisor", `List the restaurants, hotels or attractions in a Tripadvisor geo, in Tripadvisor's own ranked order, as JSON. Each row carries rating, review count, price band, address, coordinates, phone, opening hours, the Travelers' Choice badge, and the location_id + geo_id pair needed to look the place up in detail.
-
-Either geo_id or url is required. If you only have a place NAME, call resolve_tripadvisor_location first — geo ids exist only inside Tripadvisor's own URLs.
-
-category picks one of three separate URL families (restaurants, hotels, attractions), not a filter over one list; upstream default is restaurants.
-
-Paginate with page: 30 locations per page. A page beyond the last is a 404, NOT an empty result — stop when a page 404s. Costs 2 credits per page.`, {
+    server.tool("search_tripadvisor", `List restaurants/hotels/attractions in a Tripadvisor geo. 30/page, page past last = 404. geo_id or url required. 2 credits/page.`, {
         geo_id: geoIdField(),
         category: categoryField(),
         page: z.number().int().min(1).optional()
-            .describe("Results page, 1-based. 30 locations per page. A page past the last is a 404, not an empty list."),
+            .describe("Page, 1-based. Page past last = 404."),
         url: z.string().min(1).max(500).optional()
-            .describe("A full tripadvisor.com listing URL, e.g. 'https://www.tripadvisor.com/Restaurants-g30196-Austin_Texas.html', as an alternative to geo_id + category. Country sites (tripadvisor.co.uk, .fr) work. Either this or geo_id is required."),
+            .describe("Tripadvisor listing URL, alternative to geo_id."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/tripadvisor/search", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_tripadvisor_location", `Get one Tripadvisor restaurant, hotel or attraction in full as JSON: rating, the review histogram and per-aspect sub-ratings, its ranking within the city, price band, cuisines, amenities, address, coordinates, contact details, photos — and the FIRST PAGE OF REVIEWS.
-
-Because page 1 of the reviews already rides along here, do NOT call get_tripadvisor_reviews to read it; use that tool only to page PAST the first page.
-
-Either location_id or url is required, and a bare d-id additionally needs geo_id — Tripadvisor will not resolve a location without its geography. Get both from resolve_tripadvisor_location. An unknown location id is answered upstream with a 200 city listing that is BILLED and restated here as a 404, so use resolved ids rather than guesses.
-
-No pagination on this tool. Costs 2 credits.`, {
+    server.tool("get_tripadvisor_location", `Get full Tripadvisor location detail with first page of reviews included. Use get_tripadvisor_reviews only to page past page 1. location_id or url required (bare id needs geo_id too). 2 credits.`, {
         location_id: z.string().min(1).max(500).optional()
-            .describe("Tripadvisor location id — the 'd' half of the pair. Accepts '1899234', 'd1899234', or a full _Review URL. Either this or url is required."),
+            .describe("Location id, e.g. '1899234'. Either this or url required."),
         geo_id: geoIdField(),
         category: categoryField(),
         url: z.string().min(1).max(500).optional()
-            .describe("A full tripadvisor.com _Review URL, e.g. 'https://www.tripadvisor.com/Restaurant_Review-g30196-d1899234-Reviews.html', as an alternative to the id pair. Either this or location_id is required."),
+            .describe("Tripadvisor _Review URL, alternative to id pair."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/tripadvisor/location", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_tripadvisor_reviews", `Get a page of Tripadvisor reviews for one location as JSON: review text and rating, trip date and trip type, the reviewer's home town and contribution count, and any management response.
-
-Use this to page PAST page 1 — page 1 is already included in get_tripadvisor_location, so calling this for it spends a second 2-credit call on reviews you already have.
-
-Page size differs by family: 15 per page for restaurants, 10 for hotels and attractions. category must therefore MATCH the location's own type on any page past the first, or the offsets do not line up. A page beyond the last is a 404, not an empty result.
-
-Consecutive pages can REPEAT one review at the boundary — de-duplicate on review_id when concatenating pages. Either location_id or url is required (a bare d-id also needs geo_id). Costs 2 credits per page.`, {
+    server.tool("get_tripadvisor_reviews", `Page past the reviews already in get_tripadvisor_location. 15/page restaurants, 10/page hotels+attractions. Page past last = 404. De-dup on review_id at boundaries. 2 credits/page.`, {
         location_id: z.string().min(1).max(500).optional()
-            .describe("Tripadvisor location id — '1899234', 'd1899234', or a full _Review URL. Either this or url is required."),
+            .describe("Location id. Either this or url required."),
         geo_id: geoIdField(),
         category: categoryField(),
         url: z.string().min(1).max(500).optional()
-            .describe("A full tripadvisor.com _Review URL, as an alternative to the id pair. Either this or location_id is required."),
+            .describe("Tripadvisor _Review URL, alternative to id pair."),
         page: z.number().int().min(1).optional()
-            .describe("Reviews page, 1-based. 15 per page for restaurants, 10 for hotels and attractions — set category to match the location's own type. A page past the last is a 404."),
+            .describe("Page, 1-based. Match category to location type."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/tripadvisor/reviews", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);

package/dist/tools/tripadvisor.js.map

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

package/dist/tools/usage.js

@@ -1,9 +1,10 @@
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 export function registerUsageTool(server, getClient) {
-    server.tool("get_usage", `Get the current user's credit balance, plan, searches used this month, and auto-recharge settings. Use when the user asks how many credits they have left, what plan they're on, or about their usage.`, {}, async () => {
+    server.tool("get_usage", `Get credit balance, plan, and usage stats. Free.`, {}, async () => {
         try {
             const data = await getClient().get("/api/v1/usage");
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);

package/dist/tools/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,SAA6B;IAChF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,wMAAwM,EACxM,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,SAA6B;IAChF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,kDAAkD,EAClD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACpD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/walmart.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 /**
  * Walmart marketplace. This is the price-bearing parameter: com and ca bill 1
  * credit, com.mx bills 2. Only search and category accept it — walmart.ca
@@ -9,7 +10,7 @@ import { handleApiError } from "../lib/tool-error.js";
  * runs, so a default is posted on every call whether the caller meant it or not.
  */
 const domainField = z.enum(["com", "ca", "com.mx"]).optional()
-    .describe("Walmart marketplace: 'com' (US, default, 1 credit), 'ca' (Canada, 1 credit), 'com.mx' (Mexico, 2 credits). Prices and product URLs come back in that marketplace's currency and domain. Omit for US.");
+    .describe("'com' (US, 1cr), 'ca' (Canada, 1cr), 'com.mx' (Mexico, 2cr). Default US.");
 /**
  * The backend enum is CLOSED to today|tomorrow. '2_days' leaks items 3-4 days
  * out and 'anytime' is a no-op, so both were retired upstream — and a zod
@@ -17,115 +18,115 @@ const domainField = z.enum(["com", "ca", "com.mx"]).optional()
  * There is deliberately no default.
  */
 const fulfillmentSpeedField = z.enum(["today", "tomorrow"]).optional()
-    .describe("Only items deliverable today, or by tomorrow. For 'anytime', omit this parameter entirely — there is no 'anytime' value.");
+    .describe("'today' or 'tomorrow'. Omit for all items.");
 const sortByField = z.enum(["best_match", "price_low", "price_high", "best_seller", "rating_high", "new"]).optional()
-    .describe("Result sort order. Defaults to 'best_match' when omitted.");
+    .describe("Sort order. Default 'best_match'.");
 export function registerWalmartTools(server, getClient) {
-    server.tool("search_walmart", `Search Walmart.com and return structured product rows as JSON. Returns data.products, each with id (usItemId), title, url, image, price, currency, rating, rating_count, brand, seller_name, seller_catalog_id, sponsored, out_of_stock, availability_status, fulfillment and variants — plus products_count, page, max_page, has_more_pages, total_results (Walmart's own headline count, larger than what is returned), location, breadcrumb and related_searches. Page through results with the page parameter while data.has_more_pages is true. Costs 1 credit on walmart.com (default) and walmart.ca, and 2 credits on walmart.com.mx — the domain parameter sets the price. Results are always returned against Walmart's default store: delivery ZIP, store id and device emulation are not supported, and the store actually used is reported in data.location.`, {
+    server.tool("search_walmart", `Search Walmart products. Paginate with page while has_more_pages. 1 credit (US/CA), 2 credits (Mexico).`, {
         query: z.string().min(1).max(500)
-            .describe("Product search query, e.g. 'air fryer 6 quart'."),
+            .describe("Product search query."),
         page: z.number().int().min(1).optional()
-            .describe("Results page, 1-based. Defaults to page 1."),
+            .describe("Results page, 1-based."),
         sort_by: sortByField,
         min_price: z.number().optional()
-            .describe("Minimum price filter, in the marketplace's currency."),
+            .describe("Min price."),
         max_price: z.number().optional()
-            .describe("Maximum price filter, in the marketplace's currency."),
+            .describe("Max price."),
         fulfillment_speed: fulfillmentSpeedField,
         fulfillment_type: z.enum(["in_store"]).optional()
-            .describe("Set to 'in_store' to return only items available for in-store pickup. Omit for all items."),
+            .describe("'in_store' for pickup only. Omit for all."),
         domain: domainField,
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/search", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_product", `Get the full detail page for one Walmart product as JSON. Returns id/sku, title, url, image and images, price, price_strikethrough, currency, rating, rating_count, brand, model, gtin, product_type, short_description, long_description, specifications, variants, availability_status, out_of_stock, fulfillment, category_path, offer_count, location, and the seller (seller_name, seller_id as a GUID, and seller_catalog_id — the NUMERIC id that get_walmart_seller and get_walmart_seller_products require). Does NOT include review text (call get_walmart_reviews) or the seller offer list (call get_walmart_offers). Not paginated. walmart.com (US) only — there is no domain parameter, because walmart.ca product pages cannot be fetched. Costs 1 credit.`, {
+    server.tool("get_walmart_product", `Get full Walmart product detail. No reviews (use get_walmart_reviews) or offers (use get_walmart_offers). US only (no domain param). seller_catalog_id is the NUMERIC id for seller endpoints. 1 credit.`, {
         product_id: z.string().min(1)
-            .describe("Walmart item id (usItemId) — the numeric string at the end of a product URL /ip/<name>/<PRODUCT_ID>, e.g. '13544111159'."),
+            .describe("Walmart usItemId, e.g. '13544111159'."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/product", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_reviews", `Get customer reviews for a Walmart product as JSON. Returns data.reviews (review_id, rating, title, text, author, author_location, submitted_at, verified_purchase, helpful_count, unhelpful_count, photos), plus average_rating, total_review_count, reviews_with_text_count, recommended_percentage, rating_breakdown (the 1-5 star histogram), and top_positive_review / top_negative_review. Returns 10 reviews per page — page through with the page parameter, using total_review_count to know how many pages exist. Costs 1 credit per page.`, {
+    server.tool("get_walmart_reviews", `Get Walmart product reviews. 10/page, paginate with page param. Includes rating_breakdown and top positive/negative. 1 credit/page.`, {
         product_id: z.string().min(1)
-            .describe("Walmart item id (usItemId), e.g. '13544111159'."),
+            .describe("Walmart usItemId."),
         page: z.number().int().min(1).optional()
-            .describe("Reviews page, 1-based. 10 reviews per page. Defaults to page 1."),
+            .describe("Page, 1-based. 10 reviews/page."),
         sort: z.enum(["relevancy", "submission-desc", "submission-asc", "rating-desc", "rating-asc", "helpful-desc"]).optional()
-            .describe("Review sort order: 'relevancy', 'submission-desc' (newest first), 'submission-asc' (oldest), 'rating-desc' (highest rated), 'rating-asc' (lowest rated), 'helpful-desc' (most helpful)."),
+            .describe("Sort order."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/reviews", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_category", `Browse the products inside a Walmart category as JSON, without a search query. Returns exactly the same shape as search_walmart: data.products (id, title, url, image, price, rating, brand, seller_catalog_id, sponsored, fulfillment, variants), products_count, page, max_page, has_more_pages, location and breadcrumb. Page through with the page parameter while data.has_more_pages is true. The limit parameter trims the returned list after Walmart has been fetched — it does NOT reduce the cost of the call. Costs 1 credit on walmart.com (default) and walmart.ca, and 2 credits on walmart.com.mx — the domain parameter sets the price.`, {
+    server.tool("get_walmart_category", `Browse Walmart category products (no query). Same shape as search_walmart. Paginate with page while has_more_pages. limit trims locally (doesn't reduce cost). 1 credit (US/CA), 2 credits (Mexico).`, {
         category_id: z.string().min(1)
-            .describe("Walmart category id: either a leaf id ('1095191') or the full underscore-joined path ('3944_133251_1095191'). Both are accepted. Category ids appear in the breadcrumb and category_path fields of search and product responses."),
+            .describe("Category id, e.g. '1095191' or '3944_133251_1095191'."),
         page: z.number().int().min(1).optional()
-            .describe("Results page, 1-based. Defaults to page 1."),
+            .describe("Page, 1-based."),
         limit: z.number().int().min(1).optional()
-            .describe("Trim the returned products to at most this many. Applied after fetching — it does not reduce the credit cost."),
+            .describe("Max products to return (local trim, same cost)."),
         sort_by: sortByField,
         min_price: z.number().optional()
-            .describe("Minimum price filter, in the marketplace's currency."),
+            .describe("Min price."),
         max_price: z.number().optional()
-            .describe("Maximum price filter, in the marketplace's currency."),
+            .describe("Max price."),
         fulfillment_speed: fulfillmentSpeedField,
         domain: domainField,
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/category", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_offers", `Get the BUY-BOX offer for a Walmart product as JSON — which seller currently wins the listing, at what price. Returns product_id, title, url, count, total_offer_count (Walmart's own tally of purchasable offers, which is usually larger) and data.offers, each with offer_id, seller_name, seller_id, seller_catalog_id, seller_rating, seller_review_count, price, list_price, currency, condition, availability_status, shipping_price, fulfillment, wfs and is_buy_box_winner. This is NOT the full competing-offer list: Walmart server-renders only the buy-box winner, so expect one offer even when total_offer_count is higher. Not paginated. Costs 1 credit.`, {
+    server.tool("get_walmart_offers", `Get the buy-box offer for a Walmart product. Returns only the winning seller (not full offer list). Not paginated. 1 credit.`, {
         product_id: z.string().min(1)
-            .describe("Walmart item id (usItemId), e.g. '2979510112'."),
+            .describe("Walmart usItemId."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/offers", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_seller", `Get a Walmart marketplace seller's storefront as JSON. Returns seller_id (numeric) and seller_guid, name, display_name, about, logo_url, url, seller_type (EXTERNAL is a marketplace seller, INTERNAL is Walmart itself), is_marketplace_seller, has_pro_seller_badge, is_active, is_alcohol_seller, rating, review_count, reviews_with_text_count, rating_breakdown and a sample of reviews. Business contact fields (email, phone, address) come back only for sellers whose details Walmart publishes; they are null for every seller Walmart marks as exempt. IMPORTANT: seller_id must be the NUMERIC catalog seller id, which is the seller_catalog_id field on a product, search or offers response — passing the GUID seller_id from those same responses returns 404. Not paginated. Costs 1 credit.`, {
+    server.tool("get_walmart_seller", `Get a Walmart seller's storefront. IMPORTANT: seller_id must be NUMERIC seller_catalog_id (not the GUID seller_id, which 404s). 1 credit.`, {
         seller_id: z.string().min(1)
-            .describe("Numeric Walmart catalog seller id, e.g. '101480084'. Take it from the seller_catalog_id field of a product, search or offers response. The GUID-form seller_id is NOT accepted here — it 404s."),
+            .describe("Numeric seller_catalog_id, e.g. '101480084'. GUID form 404s."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/seller", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_walmart_seller_products", `List the products a Walmart marketplace seller sells, as JSON. Returns seller_id, seller_name, seller_display_name, count, products_count, total_count and data.products in the same shape as search_walmart (id, title, url, image, price, rating, brand, fulfillment, variants). HARD CAP: Walmart server-renders only roughly the FIRST 40 items and paginates the rest client-side, so this returns about 40 products no matter how large the catalog is, and there is no page or cursor parameter. Read total_count to see the seller's real catalog size and to know you are looking at a slice. IMPORTANT: seller_id must be the NUMERIC catalog seller id (the seller_catalog_id field on a product, search or offers response); the GUID form 404s. Costs 1 credit.`, {
+    server.tool("get_walmart_seller_products", `List a Walmart seller's products. HARD CAP: ~40 products max (no pagination). Use total_count for real catalog size. seller_id must be NUMERIC seller_catalog_id (GUID 404s). 1 credit.`, {
         seller_id: z.string().min(1)
-            .describe("Numeric Walmart catalog seller id, e.g. '101480084', from the seller_catalog_id field of a product, search or offers response. The GUID-form seller_id 404s."),
+            .describe("Numeric seller_catalog_id, e.g. '101480084'. GUID form 404s."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/walmart/seller-products", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);

package/dist/tools/walmart.js.map

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

package/dist/tools/x.js

@@ -1,153 +1,154 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 export function registerXTools(server, getClient) {
-    server.tool("search_x", `Search X for tweets and people as JSON. Each result includes the tweet ID, author handle, text, language, timestamp, and engagement counts (favorites, retweets, replies, quotes, bookmarks, views). Use data.next_cursor as the next cursor while has_more is true. Costs 1 credit. Use when the user asks to find tweets or accounts about a topic.`, {
+    server.tool("search_x", `Search X tweets and people. Paginate with next_cursor/has_more. 1 credit.`, {
         search: z.string().min(1).max(500)
-            .describe("X search query."),
+            .describe("Search query."),
         search_type: z.enum(["Top", "Latest", "People", "Photos", "Videos"]).optional()
-            .describe("Result category. 'Top' (default), 'Latest', 'People', 'Photos', or 'Videos'."),
+            .describe("Top (default), Latest, People, Photos, Videos."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/search", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_tweet", `Get full details for a single tweet as JSON. Returns the tweet ID, text, display text, timestamp, language, engagement counts (favorites, retweets, replies, quotes, bookmarks, views), source, and reply-to reference. Accepts a tweet ID. Costs 1 credit.`, {
+    server.tool("get_tweet", `Get a single tweet's full details. 1 credit.`, {
         tweet_id: z.string().min(1)
-            .describe("Tweet ID, e.g. '1808168603721650364'."),
+            .describe("Tweet ID."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/tweet", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_tweet_comments", `Get replies to a tweet as JSON, ranked or chronological. Each reply includes the tweet ID, author handle, text, timestamp, and engagement counts. Accepts a tweet ID. Use data.next_cursor as the next cursor while has_more is true. Costs 1 credit.`, {
+    server.tool("get_tweet_comments", `Get replies to a tweet. Paginate with next_cursor/has_more. 1 credit.`, {
         tweet_id: z.string().min(1)
-            .describe("Tweet ID, e.g. '1808168603721650364'."),
+            .describe("Tweet ID."),
         rank: z.enum(["top", "latest"]).optional()
-            .describe("'top' for ranked replies (default), 'latest' for chronological."),
+            .describe("'top' (default) or 'latest'."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/tweet/comments", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_tweet_retweeters", `Get the users who retweeted a tweet as JSON. Each user includes the user ID, handle, name, description, follower/friends/statuses/media counts, and profile image. Accepts a tweet ID. Use data.next_cursor as the next cursor while has_more is true. Costs 1 credit.`, {
+    server.tool("get_tweet_retweeters", `Get users who retweeted a tweet. Paginate with next_cursor/has_more. 1 credit.`, {
         tweet_id: z.string().min(1)
-            .describe("Tweet ID, e.g. '1808168603721650364'."),
+            .describe("Tweet ID."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/tweet/retweeters", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user", `Get an X user's profile as JSON. Returns the rest ID, handle, name, description, follower/friends/statuses/media counts, verified flag, avatar, header image, location, website, and creation date. Accepts a handle (without @). Costs 1 credit.`, {
+    server.tool("get_x_user", `Get an X user's profile. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @, e.g. 'elonmusk'."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user_tweets", `List an X user's tweets as JSON in data.timeline, plus data.pinned (a pinned tweet or null) and data.user (the author's profile). Each tweet includes the tweet ID, text, timestamp, engagement counts, and conversation ID. Accepts a handle (without @). Use data.next_cursor as the next cursor; this endpoint returns no has_more, so stop when next_cursor is absent or the timeline comes back empty. Costs 1 credit.`, {
+    server.tool("get_x_user_tweets", `List an X user's tweets. No has_more; stop when next_cursor absent or timeline empty. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user/tweets", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user_replies", `List an X user's tweets and replies as JSON in data.timeline, plus data.user (the author's profile). Each entry includes the tweet ID, text, timestamp, and engagement counts. Accepts a handle (without @). Use data.next_cursor as the next cursor; this endpoint returns no has_more, so stop when next_cursor is absent or the timeline comes back empty. Costs 1 credit.`, {
+    server.tool("get_x_user_replies", `List an X user's tweets and replies. No has_more; stop when next_cursor absent or timeline empty. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user/replies", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user_media", `List an X user's media tweets (posts with photos or videos) as JSON in data.timeline, plus data.user (the author's profile). Each entry includes the tweet ID, text, timestamp, and engagement counts. Accepts a handle (without @). Use data.next_cursor as the next cursor; this endpoint returns no has_more, so stop when next_cursor is absent or the timeline comes back empty. Costs 1 credit.`, {
+    server.tool("get_x_user_media", `List an X user's media tweets. No has_more; stop when next_cursor absent or timeline empty. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user/media", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user_followers", `List an X user's followers as JSON. Each follower includes the user ID, handle, name, description, follower count, verified flag, and location. Accepts a handle (without @). Use data.next_cursor as the next cursor while has_more is true. Costs 1 credit.`, {
+    server.tool("get_x_user_followers", `List an X user's followers. Paginate with next_cursor/has_more. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user/followers", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_user_followings", `List the accounts an X user follows as JSON, under data.following (singular, unlike the tool name). Each account includes the user ID, handle, name, description, follower count, verified flag, and location. Accepts a handle (without @). Use data.next_cursor as the next cursor while has_more is true. Costs 1 credit.`, {
+    server.tool("get_x_user_followings", `List accounts an X user follows (data.following). Paginate with next_cursor/has_more. 1 credit.`, {
         screen_name: z.string().min(1)
-            .describe("An X handle without the @, e.g. 'elonmusk'."),
+            .describe("Handle without @."),
         cursor: z.string().optional()
-            .describe("Pagination cursor (next_cursor) from a previous response."),
+            .describe("next_cursor from previous response."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/user/followings", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_x_trending", `Get trending topics on X for a country as JSON. Each trend includes its name, description, and context. Costs 1 credit.`, {
+    server.tool("get_x_trending", `Get trending topics on X for a country. 1 credit.`, {
         country: z.string().optional()
-            .describe("Country name, e.g. 'UnitedStates' (default), 'UnitedKingdom', 'Japan'."),
+            .describe("e.g. 'UnitedStates' (default), 'UnitedKingdom', 'Japan'."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/x/trending", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);