@scavio/mcp-server 0.13.1 → 0.14.1

package/dist/tools/g2.js

@@ -1,65 +1,66 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 export function registerG2Tools(server, getClient) {
-    server.tool("search_g2_software", `G2, the B2B software review site. Search it for business software products and get ranked rows back as JSON: product name, star rating, review count, vendor, categories, seller description and logo. Every row carries the product_id and slug that get_g2_product and get_g2_reviews take, so this is the entry point when you only have a product name or a category ("CRM", "project management"). Also returns total_results - G2's Products-tab headline, capped at 10000 - and total_by_type, which breaks the same query across products, sellers, categories and discussions. Paginate with the page parameter; limit is capped at 100 results per request. Pass query or url - at least one is required. COSTS 5 CREDITS PER CALL: G2 is the most expensive platform Scavio serves, so search once with a good query rather than probing. A G2 bot wall comes back as an error that was still billed upstream, so retry sparingly.`, {
+    server.tool("search_g2_software", `Search G2 B2B software products. 5 credits/call (most expensive platform). Query or url required.`, {
         query: z.string().min(1).max(200).optional()
-            .describe("Software search term, e.g. 'project management' or 'notion'. Either this or url is required."),
+            .describe("Search term, e.g. 'project management'."),
         url: z.string().min(1).max(1000).optional()
-            .describe("Full g2.com search URL to run verbatim, e.g. 'https://www.g2.com/search?query=crm'. Either this or query is required."),
+            .describe("g2.com search URL instead of query."),
         page: z.number().int().min(1).optional()
-            .describe("Page number (1-indexed). 20 results per page unless limit says otherwise."),
+            .describe("Page, 1-based."),
         limit: z.number().int().min(1).max(100).optional()
-            .describe("Results per page, 1-100 (default 20). 100 is our hard cap so a single request cannot ask for a multi-megabyte page; G2 itself keeps paginating at any size, so use page to go deeper."),
+            .describe("Per page, 1-100. Default 20."),
         sort: z.enum(["relevance", "popular", "alphabetical", "rating"]).optional()
-            .describe("Sort order (default 'relevance'). Closed enum on purpose: G2 silently accepts an unknown sort and answers 200 in some unstated order, so an invalid value would look like it worked."),
+            .describe("Sort order."),
         rating: z.number().int().min(1).max(5).optional()
-            .describe("Only products at or above this star rating (1-5)."),
+            .describe("Min star rating."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/g2/search", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_g2_product", `G2, the B2B software review site. Get one software product's full G2 profile as JSON: overall rating with the per-star histogram, review count, vendor, description and seller website, pricing editions with parsed amounts, feature groups, categories and breadcrumbs, supported languages, integrations, alternatives, head-to-head comparisons, media, community discussions, and G2's AI-derived pros and cons. THIS ENDPOINT CARRIES NO REVIEW TEXT AT ALL - G2 loads review bodies in a separate frame, so call get_g2_reviews for the actual written reviews. No pagination: one call returns the whole profile. product_id accepts either the slug ('notion') or the numeric G2 id ('82623') as a string; both resolve. Pass product_id or url - at least one is required. COSTS 5 CREDITS PER CALL, the most expensive platform Scavio serves. A G2 bot wall comes back as an error that was still billed upstream, so retry sparingly.`, {
+    server.tool("get_g2_product", `Get G2 product profile: ratings, pricing, features, alternatives. No review text; use get_g2_reviews. 5 credits.`, {
         product_id: z.string().min(1).max(200).optional()
-            .describe("G2 product slug ('notion') or numeric G2 id as a string ('82623') - both resolve on the same upstream path. Either this or url is required."),
+            .describe("Product slug ('notion') or numeric id ('82623')."),
         url: z.string().min(1).max(1000).optional()
-            .describe("Full g2.com product URL, e.g. 'https://www.g2.com/products/notion/reviews'. Either this or product_id is required."),
+            .describe("g2.com product URL instead of product_id."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/g2/product", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_g2_reviews", `G2, the B2B software review site. Get one page of written reviews for a software product as JSON: star rating, title, what the reviewer likes and dislikes, problems solved, reviewer job title, industry and company size, and validated/incentivized flags. This is the ONLY G2 tool that returns review text - get_g2_product deliberately has none. It also carries what the profile page has no form of: exact per-star review counts, pros and cons with per-theme counts, and company_size / role / industry / region / category facets with counts. Reviews are FIXED AT 10 PER PAGE and paginate well past the 10 pages G2's own widget links to, so walk page upward. The rating filter is HALF-STAR-INCLUSIVE: rating=1 returns 0, 0.5 and 1-star reviews. Every filter is a closed enum because an unrecognised filter value MATCHES NOTHING upstream and returns "Reviews (0)", which reads like the product genuinely has no such reviews. Pass product_id or url - at least one is required. COSTS 5 CREDITS PER PAGE, the most expensive platform Scavio serves, so filter down rather than paging blindly.`, {
+    server.tool("get_g2_reviews", `Get G2 review text for a product. 10 per page. rating filter is half-star-inclusive. 5 credits/page.`, {
         product_id: z.string().min(1).max(200).optional()
-            .describe("G2 product slug ('notion') or numeric G2 id as a string ('82623'). Either this or url is required."),
+            .describe("Product slug or numeric id."),
         url: z.string().min(1).max(1000).optional()
-            .describe("Full g2.com reviews URL. Either this or product_id is required."),
+            .describe("g2.com reviews URL instead of product_id."),
         page: z.number().int().min(1).optional()
-            .describe("Page number (1-indexed). Fixed at 10 reviews per page; pages continue well past the 10 G2's own widget links to."),
+            .describe("Page, 1-based. 10 per page."),
         sort: z.enum(["relevance", "newest", "most_helpful", "rating_high", "rating_low"]).optional()
-            .describe("Review sort order (default 'relevance'). Closed enum: G2 silently accepts an unknown sort and returns a full result set in some unstated order."),
+            .describe("Sort order."),
         rating: z.number().int().min(1).max(5).optional()
-            .describe("Star bucket, 1-5. HALF-STAR-INCLUSIVE: 1 returns 0, 0.5 and 1-star reviews."),
+            .describe("Star bucket. Half-star-inclusive: 1 includes 0-1 stars."),
         company_size: z.enum(["small_business", "mid_market", "enterprise"]).optional()
-            .describe("Reviewer company size: small_business (<=50 employees), mid_market (51-1000), enterprise (>1000). An unrecognised value would silently match nothing, hence the closed enum."),
+            .describe("small_business <=50, mid_market 51-1000, enterprise >1000."),
         role: z.enum(["user", "administrator", "executive_sponsor", "internal_consultant", "consultant", "agency", "industry_analyst"]).optional()
-            .describe("Reviewer's relationship to the product."),
+            .describe("Reviewer role."),
         region: z.enum(["north_america", "europe", "asia", "latin_america", "anz", "middle_east", "africa"]).optional()
             .describe("Reviewer region."),
         query: z.string().min(1).max(200).optional()
-            .describe("Full-text search within this product's reviews. Narrows the review list AND every facet count."),
+            .describe("Text search within reviews."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/g2/reviews", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);

package/dist/tools/g2.js.map

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

package/dist/tools/glassdoor.js

@@ -1,68 +1,69 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
 // employer_id / company / url repeat on three of the four endpoints. `company`
 // is cosmetic on all of them and does NOT satisfy the identifier requirement —
 // the backend refine takes employer_id or url only.
 const employerIdField = z.string().min(1).max(50).optional()
-    .describe("Glassdoor employer id as a STRING, in any form Glassdoor writes it: '1699', 'E1699' or 'IE1699'. A JSON number is rejected. Get one from resolve_glassdoor_company. Either this or url is required.");
+    .describe("Employer id as string, e.g. '1699' or 'E1699'. Not a number. Either this or url required.");
 const companyField = z.string().min(1).max(200).optional()
-    .describe("Employer name as it appears in a Glassdoor slug, e.g. 'NIKE'. COSMETIC ONLY - the profile resolves on employer_id alone, and this is ignored entirely when url is set. It does NOT satisfy the employer_id-or-url requirement.");
+    .describe("Employer slug name, e.g. 'NIKE'. Cosmetic only.");
 export function registerGlassdoorTools(server, getClient) {
-    server.tool("resolve_glassdoor_company", `START HERE for Glassdoor. Search Glassdoor for a company by name and resolve it to the employer_id that every other Glassdoor tool requires. Returns data with ranked, de-duplicated employer matches, each carrying its employer_id, name and profile URL. The employer_id lives only inside Glassdoor's /Overview/ URLs, so call this first unless you already hold one. No pagination - one ranked set per query. Glassdoor is slow and flaky: expect seconds to tens of seconds, and an occasional 502 after as long as ~3 minutes; retry once before giving up. Costs 1 credit.`, {
+    server.tool("resolve_glassdoor_company", `Resolve a company name to a Glassdoor employer_id. Start here. Slow (seconds-minutes), retry on 502. 1 credit.`, {
         query: z.string().min(1).max(120)
-            .describe("Company name to resolve, e.g. 'Nike'."),
+            .describe("Company name, e.g. 'Nike'."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/glassdoor/companies", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_glassdoor_company", `Get a Glassdoor employer profile as JSON: description, mission, industry, sector, HQ, size band, revenue band, stock symbol, year founded, overall and per-category ratings, star distribution, CEO approval, awards, FAQ, the five server-rendered reviews, plus reviews_url and salaries_url. THE CHAINING STEP: pass reviews_url or salaries_url back as the url parameter of get_glassdoor_reviews / get_glassdoor_salaries to halve the upstream work those calls do. Requires employer_id or url - company alone is NOT an address and is rejected. Use resolve_glassdoor_company to turn a name into an employer_id. No pagination. Slow (roughly 3-47 seconds) and occasionally 502s; retry once. Costs 1 credit.`, {
+    server.tool("get_glassdoor_company", `Get Glassdoor employer profile with ratings, reviews, and reviews_url/salaries_url for chaining. employer_id or url required. Slow; retry on 502. 1 credit.`, {
         employer_id: employerIdField,
         company: companyField,
         url: z.string().min(1).max(500).optional()
-            .describe("Any glassdoor.com employer URL - /Overview/, /Reviews/ or /Salary/, e.g. 'https://www.glassdoor.com/Overview/Working-at-NIKE-EI_IE1699.11,15.htm'. A non-glassdoor.com host is rejected. Either this or employer_id is required."),
+            .describe("Glassdoor employer URL. Either this or employer_id required."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/glassdoor/company", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_glassdoor_reviews", `Get Glassdoor employee reviews for one employer as JSON: up to THREE full reviews with per-axis scores, pros, cons, advice to management, job title, location, employment status and employer response - plus complete rating statistics, star distribution, aggregate pro/con highlight terms and per-job-title review counts. HARD CAP OF THREE REVIEWS per call (Glassdoor's login wall) and there is deliberately NO page parameter, so do not attempt to paginate. Move the window with category and employment_status instead, and read filtered_review_count on the response to see how many reviews match. Requires employer_id or url - company alone is NOT an address. Passing the reviews_url from get_glassdoor_company as url skips a fetch. Slow (~75 seconds); retry once on a 502. Costs 1 credit.`, {
+    server.tool("get_glassdoor_reviews", `Get Glassdoor reviews (max 3 per call, login wall). No pagination. Use category/employment_status to shift window. Pass reviews_url from get_glassdoor_company as url to skip a fetch. Slow (~75s). 1 credit.`, {
         employer_id: employerIdField,
         company: companyField,
         url: z.string().min(1).max(500).optional()
-            .describe("Any glassdoor.com employer URL. Preferably the reviews_url returned by get_glassdoor_company, which skips the resolve fetch. A non-glassdoor.com host is rejected. Either this or employer_id is required."),
+            .describe("Glassdoor URL. Prefer reviews_url from get_glassdoor_company. Either this or employer_id."),
         category: z.enum(["career_development", "compensation", "culture", "diversity_and_inclusion", "management", "work_life_balance"]).optional()
-            .describe("Restrict to reviews Glassdoor files under one topic. Closed set: Glassdoor silently IGNORES an unknown value and serves the unfiltered set under a 200."),
+            .describe("Review topic filter."),
         employment_status: z.enum(["full_time", "part_time", "contract", "intern"]).optional()
-            .describe("Restrict to one kind of employment. Closed set: Glassdoor silently IGNORES an unknown value and serves the unfiltered set under a 200."),
+            .describe("Employment type filter."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/glassdoor/reviews", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);
         }
     });
-    server.tool("get_glassdoor_salaries", `Get Glassdoor salary data for one employer as JSON, broken down by job title: base-pay and total-pay percentiles P10-P90 with medians called out, sample counts, currency, pay period and last-reported date. These are Glassdoor's ESTIMATES for each job title, not individual reported salaries. Ten job titles per page - pass page for the next ten and read page_count on the response for how many pages exist. Requires employer_id or url - company alone is NOT an address. Passing the salaries_url from get_glassdoor_company as url skips a fetch. Slow (~41 seconds); retry once on a 502. Costs 1 credit per page.`, {
+    server.tool("get_glassdoor_salaries", `Get Glassdoor salary estimates by job title (P10-P90 percentiles). 10 titles/page. Pass salaries_url from get_glassdoor_company to skip a fetch. Slow (~41s). 1 credit/page.`, {
         employer_id: employerIdField,
         company: companyField,
         url: z.string().min(1).max(500).optional()
-            .describe("Any glassdoor.com employer URL. Preferably the salaries_url returned by get_glassdoor_company, which skips the resolve fetch. A non-glassdoor.com host is rejected. Either this or employer_id is required."),
+            .describe("Glassdoor URL. Prefer salaries_url from get_glassdoor_company. Either this or employer_id."),
         page: z.number().int().min(1).optional()
-            .describe("Results page, 1-based. Ten job titles per page; page_count on the response is how many pages there are. Defaults to 1."),
+            .describe("Page, 1-based. 10 titles/page."),
     }, async (params) => {
         try {
             const data = await getClient().post("/api/v1/glassdoor/salaries", params);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return trimResponse(data);
         }
         catch (err) {
             return handleApiError(err);

package/dist/tools/glassdoor.js.map

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