@nanogpt/mcp 1.1.6 → 1.3.0

package/dist/tools/researchTools.js

@@ -0,0 +1,241 @@
+/**
+ * NanoGPT research/data tools.
+ */
+import { z } from 'zod';
+import { requestJson } from '../httpClient.js';
+import { handleToolError, processRawResponse, buildContent, zodToJsonSchema } from '../toolUtils.js';
+const paramValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.array(z.union([z.string(), z.number(), z.boolean()])),
+]);
+const paramsSchema = z.record(paramValueSchema).optional();
+export const xResearchInputSchema = z.object({
+    endpoint: z.enum([
+        'endpoints',
+        'search',
+        'search/recent',
+        'search/all',
+        'counts',
+        'counts/recent',
+        'counts/all',
+        'tweet',
+        'tweets',
+        'tweet/quotes',
+        'tweet/retweeted-by',
+        'tweet/liking-users',
+        'user',
+        'users',
+        'user/search',
+        'user/tweets',
+        'user/mentions',
+        'user/liked-tweets',
+        'user/followers',
+        'user/following',
+        'list',
+        'list/tweets',
+        'list/members',
+        'list/followers',
+        'space',
+        'spaces',
+        'spaces/search',
+    ]).default('endpoints')
+        .describe('X Research endpoint to call. Use endpoints to list supported routes.'),
+    params: paramsSchema
+        .describe('Query parameters for the selected X endpoint, such as query, username, id, ids, limit, or next_token.'),
+    include_raw: z.boolean().optional().default(false)
+        .describe('Include the raw NanoGPT API response for debugging. Large raw responses are returned as a resource link.'),
+});
+export const hunterInputSchema = z.object({
+    endpoint: z.enum([
+        'endpoints',
+        'discover',
+        'domain-search',
+        'email-finder',
+        'email-verifier',
+        'people/find',
+        'email-enrichment',
+        'people-find',
+        'person-enrichment',
+        'companies/find',
+        'company-enrichment',
+        'companies-find',
+        'combined/find',
+        'combined-enrichment',
+        'combined-find',
+        'email-count',
+    ]).default('endpoints')
+        .describe('Hunter endpoint to call. Use endpoints to list supported Hunter routes and pricing.'),
+    params: z.record(z.unknown()).optional()
+        .describe('Parameters for the Hunter endpoint, such as domain, company, email, full_name, first_name, last_name, or linkedin_handle.'),
+    include_raw: z.boolean().optional().default(false)
+        .describe('Include the raw NanoGPT API response for debugging. Large raw responses are returned as a resource link.'),
+});
+const dataToolOutputSchema = z.object({
+    data: z.unknown(),
+    billing: z.record(z.unknown()).optional(),
+    meta: z.record(z.unknown()).optional(),
+    status: z.number().optional(),
+    raw: z.union([z.record(z.unknown()), z.string()]).optional(),
+});
+export const xResearchInputJsonSchema = zodToJsonSchema(xResearchInputSchema);
+export const hunterInputJsonSchema = zodToJsonSchema(hunterInputSchema);
+export const outputJsonSchema = zodToJsonSchema(dataToolOutputSchema);
+export const xResearch = {
+    name: 'nanogpt_x_research',
+    description: 'Retrieve public X data through NanoGPT billing: search, counts, posts, users, timelines, lists, and Spaces.',
+    inputSchema: xResearchInputSchema,
+    inputJsonSchema: xResearchInputJsonSchema,
+    outputJsonSchema,
+    annotations: { readOnlyHint: false, openWorldHint: true },
+    handler: async (args) => {
+        try {
+            const input = xResearchInputSchema.parse(args);
+            const endpoint = input.endpoint === 'endpoints' ? 'endpoints' : input.endpoint;
+            const response = await requestJson({
+                method: 'GET',
+                path: `/api/v1/x/${endpoint}`,
+                query: stringifyParams(input.params),
+            });
+            return buildDataToolResult({
+                label: 'X Research',
+                endpoint,
+                response,
+                includeRaw: input.include_raw,
+            });
+        }
+        catch (err) {
+            return handleToolError(err);
+        }
+    },
+};
+export const hunter = {
+    name: 'nanogpt_hunter',
+    description: 'Use Hunter.io through NanoGPT billing for domain search, email finding, email verification, enrichment, discovery, and email counts.',
+    inputSchema: hunterInputSchema,
+    inputJsonSchema: hunterInputJsonSchema,
+    outputJsonSchema,
+    annotations: { readOnlyHint: false, openWorldHint: true },
+    handler: async (args) => {
+        try {
+            const input = hunterInputSchema.parse(args);
+            const endpoint = input.endpoint === 'endpoints' ? '' : input.endpoint;
+            const response = await requestJson({
+                method: 'POST',
+                path: '/api/v1/hunter',
+                body: {
+                    endpoint,
+                    params: input.params || {},
+                },
+            });
+            return buildDataToolResult({
+                label: 'Hunter',
+                endpoint: input.endpoint,
+                response,
+                includeRaw: input.include_raw,
+            });
+        }
+        catch (err) {
+            return handleToolError(err);
+        }
+    },
+};
+function stringifyParams(params) {
+    const query = {};
+    if (!params)
+        return query;
+    for (const [key, value] of Object.entries(params)) {
+        if (Array.isArray(value)) {
+            query[key] = value.map(String).join(',');
+        }
+        else {
+            query[key] = String(value);
+        }
+    }
+    return query;
+}
+function buildDataToolResult({ label, endpoint, response, includeRaw, }) {
+    const data = response.json;
+    const output = {
+        data: data.data ?? data,
+    };
+    if (data.billing && typeof data.billing === 'object')
+        output.billing = data.billing;
+    if (data.meta && typeof data.meta === 'object')
+        output.meta = data.meta;
+    if (typeof data.status === 'number')
+        output.status = data.status;
+    const { raw, resourceLink } = processRawResponse({ status: response.status, headers: response.headers, body: data }, includeRaw);
+    if (raw !== undefined)
+        output.raw = raw;
+    return {
+        content: buildContent(formatDataToolText(label, endpoint, data), resourceLink),
+        structuredContent: output,
+    };
+}
+function formatDataToolText(label, endpoint, data) {
+    const primary = data.data ?? data;
+    const count = countPrimaryItems(primary);
+    let text = `${label} ${endpoint || 'endpoints'} returned ${count.label}.`;
+    const billing = data.billing;
+    if (billing && typeof billing === 'object') {
+        const record = billing;
+        const actualUsd = typeof record.actual_usd === 'number' ? record.actual_usd : undefined;
+        const estimatedUsd = typeof record.estimated_usd === 'number' ? record.estimated_usd : undefined;
+        if (actualUsd !== undefined)
+            text += ` Actual cost: $${actualUsd.toFixed(6)}.`;
+        if (estimatedUsd !== undefined)
+            text += ` Estimated cost: $${estimatedUsd.toFixed(6)}.`;
+    }
+    const preview = previewPrimary(primary);
+    if (preview)
+        text += `\n\nPreview:\n${preview}`;
+    return text;
+}
+function countPrimaryItems(value) {
+    if (Array.isArray(value))
+        return { label: `${value.length} item${value.length === 1 ? '' : 's'}`, count: value.length };
+    if (value && typeof value === 'object') {
+        const record = value;
+        if (Array.isArray(record.data))
+            return { label: `${record.data.length} data item${record.data.length === 1 ? '' : 's'}`, count: record.data.length };
+        if (record.data)
+            return { label: '1 data item', count: 1 };
+        if (Array.isArray(record.endpoints))
+            return { label: `${record.endpoints.length} endpoint${record.endpoints.length === 1 ? '' : 's'}`, count: record.endpoints.length };
+        return { label: `${Object.keys(record).length} field${Object.keys(record).length === 1 ? '' : 's'}` };
+    }
+    return { label: value === null || value === undefined ? 'no data' : '1 value', count: value === null || value === undefined ? 0 : 1 };
+}
+function previewPrimary(value) {
+    const items = Array.isArray(value)
+        ? value
+        : value && typeof value === 'object' && Array.isArray(value.data)
+            ? value.data
+            : value && typeof value === 'object' && Array.isArray(value.endpoints)
+                ? value.endpoints
+                : null;
+    if (!items || items.length === 0)
+        return null;
+    return items.slice(0, 3).map((item, index) => `- ${index + 1}: ${summarizeDataItem(item)}`).join('\n');
+}
+function summarizeDataItem(item) {
+    if (!item || typeof item !== 'object')
+        return String(item);
+    const record = item;
+    const parts = ['id', 'name', 'username', 'email', 'domain', 'title', 'text']
+        .map((key) => {
+        const value = record[key];
+        if (typeof value !== 'string' && typeof value !== 'number')
+            return null;
+        const text = String(value).replace(/\s+/g, ' ').trim();
+        return text ? `${key}: ${text.slice(0, 120)}${text.length > 120 ? '...' : ''}` : null;
+    })
+        .filter((part) => Boolean(part))
+        .slice(0, 3);
+    if (parts.length > 0)
+        return parts.join(', ');
+    return `fields: ${Object.keys(record).slice(0, 8).join(', ')}`;
+}
+//# sourceMappingURL=researchTools.js.map

package/dist/tools/researchTools.js.map

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

package/dist/tools/webSearch.d.ts

@@ -2,19 +2,22 @@
  * nanogpt_web_search tool
  *
  * Search the web for current information using multiple providers:
- * - linkup: Default provider, supports standard/deep depth
+ * - linkup: Default provider, supports standard/deep depth and richer output types
  * - tavily: Advanced search with answer generation, topic filtering
  * - exa: Neural/semantic search with content extraction
  * - kagi: Privacy-focused search with web/news/search modes
  * - perplexity: AI-powered search with domain/language filtering
+ * - valyu: Aggregated web retrieval with configurable budgets
+ * - brave: Brave Search API (web/news/images/video/local)
  */
 import { z } from 'zod';
 export declare const inputSchema: z.ZodObject<{
     query: z.ZodString;
-    provider: z.ZodOptional<z.ZodEnum<["linkup", "tavily", "exa", "kagi", "perplexity"]>>;
+    provider: z.ZodOptional<z.ZodEnum<["linkup", "tavily", "exa", "kagi", "perplexity", "valyu", "brave"]>>;
     depth: z.ZodOptional<z.ZodEnum<["standard", "deep", "fast", "auto", "neural"]>>;
     maxResults: z.ZodOptional<z.ZodNumber>;
     includeImages: z.ZodOptional<z.ZodBoolean>;
+    includeImageDescriptions: z.ZodOptional<z.ZodBoolean>;
     fromDate: z.ZodOptional<z.ZodString>;
     toDate: z.ZodOptional<z.ZodString>;
     excludeDomains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -28,7 +31,16 @@ export declare const inputSchema: z.ZodObject<{
     timeRange: z.ZodOptional<z.ZodEnum<["day", "week", "month", "year", "d", "w", "m", "y"]>>;
     chunksPerSource: z.ZodOptional<z.ZodNumber>;
     country: z.ZodOptional<z.ZodString>;
+    numResults: z.ZodOptional<z.ZodNumber>;
     category: z.ZodOptional<z.ZodEnum<["company", "research paper", "news", "pdf", "github", "tweet", "personal site", "people", "financial report"]>>;
+    userLocation: z.ZodOptional<z.ZodString>;
+    additionalQueries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    startCrawlDate: z.ZodOptional<z.ZodString>;
+    endCrawlDate: z.ZodOptional<z.ZodString>;
+    startPublishedDate: z.ZodOptional<z.ZodString>;
+    endPublishedDate: z.ZodOptional<z.ZodString>;
+    includeText: z.ZodOptional<z.ZodString>;
+    excludeText: z.ZodOptional<z.ZodString>;
     context: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
         maxCharacters: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
@@ -103,14 +115,36 @@ export declare const inputSchema: z.ZodObject<{
     maxTokensPerPage: z.ZodOptional<z.ZodNumber>;
     searchDomainFilter: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     searchLanguageFilter: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    count: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    safesearch: z.ZodOptional<z.ZodEnum<["off", "moderate", "strict"]>>;
+    freshness: z.ZodOptional<z.ZodString>;
+    searchLang: z.ZodOptional<z.ZodString>;
+    uiLang: z.ZodOptional<z.ZodString>;
+    extraSnippets: z.ZodOptional<z.ZodBoolean>;
+    spellcheck: z.ZodOptional<z.ZodBoolean>;
+    goggles: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    searchType: z.ZodOptional<z.ZodEnum<["all", "web"]>>;
+    fastMode: z.ZodOptional<z.ZodBoolean>;
+    maxNumResults: z.ZodOptional<z.ZodNumber>;
+    maxPrice: z.ZodOptional<z.ZodNumber>;
+    relevanceThreshold: z.ZodOptional<z.ZodNumber>;
+    responseLength: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodEnum<["short", "medium", "large", "max"]>]>>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    includedSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    excludedSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    urlOnly: z.ZodOptional<z.ZodBoolean>;
+    valyuCategory: z.ZodOptional<z.ZodString>;
+    isToolCall: z.ZodOptional<z.ZodBoolean>;
     include_raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     query: string;
     include_raw: boolean;
-    provider?: "linkup" | "tavily" | "exa" | "kagi" | "perplexity" | undefined;
+    provider?: "linkup" | "tavily" | "exa" | "kagi" | "perplexity" | "valyu" | "brave" | undefined;
     depth?: "auto" | "standard" | "deep" | "fast" | "neural" | undefined;
     maxResults?: number | undefined;
     includeImages?: boolean | undefined;
+    includeImageDescriptions?: boolean | undefined;
     fromDate?: string | undefined;
     toDate?: string | undefined;
     excludeDomains?: string[] | undefined;
@@ -124,7 +158,16 @@ export declare const inputSchema: z.ZodObject<{
     timeRange?: "day" | "week" | "month" | "year" | "d" | "w" | "m" | "y" | undefined;
     chunksPerSource?: number | undefined;
     country?: string | undefined;
+    numResults?: number | undefined;
     category?: "news" | "company" | "research paper" | "pdf" | "github" | "tweet" | "personal site" | "people" | "financial report" | undefined;
+    userLocation?: string | undefined;
+    additionalQueries?: string[] | undefined;
+    startCrawlDate?: string | undefined;
+    endCrawlDate?: string | undefined;
+    startPublishedDate?: string | undefined;
+    endPublishedDate?: string | undefined;
+    includeText?: string | undefined;
+    excludeText?: string | undefined;
     context?: boolean | {
         maxCharacters?: number | undefined;
     } | undefined;
@@ -147,13 +190,35 @@ export declare const inputSchema: z.ZodObject<{
     maxTokensPerPage?: number | undefined;
     searchDomainFilter?: string[] | undefined;
     searchLanguageFilter?: string[] | undefined;
+    count?: number | undefined;
+    offset?: number | undefined;
+    safesearch?: "off" | "moderate" | "strict" | undefined;
+    freshness?: string | undefined;
+    searchLang?: string | undefined;
+    uiLang?: string | undefined;
+    extraSnippets?: boolean | undefined;
+    spellcheck?: boolean | undefined;
+    goggles?: string | string[] | undefined;
+    searchType?: "web" | "all" | undefined;
+    fastMode?: boolean | undefined;
+    maxNumResults?: number | undefined;
+    maxPrice?: number | undefined;
+    relevanceThreshold?: number | undefined;
+    responseLength?: number | "max" | "short" | "medium" | "large" | undefined;
+    countryCode?: string | undefined;
+    includedSources?: string[] | undefined;
+    excludedSources?: string[] | undefined;
+    urlOnly?: boolean | undefined;
+    valyuCategory?: string | undefined;
+    isToolCall?: boolean | undefined;
 }, {
     query: string;
     include_raw?: boolean | undefined;
-    provider?: "linkup" | "tavily" | "exa" | "kagi" | "perplexity" | undefined;
+    provider?: "linkup" | "tavily" | "exa" | "kagi" | "perplexity" | "valyu" | "brave" | undefined;
     depth?: "auto" | "standard" | "deep" | "fast" | "neural" | undefined;
     maxResults?: number | undefined;
     includeImages?: boolean | undefined;
+    includeImageDescriptions?: boolean | undefined;
     fromDate?: string | undefined;
     toDate?: string | undefined;
     excludeDomains?: string[] | undefined;
@@ -167,7 +232,16 @@ export declare const inputSchema: z.ZodObject<{
     timeRange?: "day" | "week" | "month" | "year" | "d" | "w" | "m" | "y" | undefined;
     chunksPerSource?: number | undefined;
     country?: string | undefined;
+    numResults?: number | undefined;
     category?: "news" | "company" | "research paper" | "pdf" | "github" | "tweet" | "personal site" | "people" | "financial report" | undefined;
+    userLocation?: string | undefined;
+    additionalQueries?: string[] | undefined;
+    startCrawlDate?: string | undefined;
+    endCrawlDate?: string | undefined;
+    startPublishedDate?: string | undefined;
+    endPublishedDate?: string | undefined;
+    includeText?: string | undefined;
+    excludeText?: string | undefined;
     context?: boolean | {
         maxCharacters?: number | undefined;
     } | undefined;
@@ -190,6 +264,27 @@ export declare const inputSchema: z.ZodObject<{
     maxTokensPerPage?: number | undefined;
     searchDomainFilter?: string[] | undefined;
     searchLanguageFilter?: string[] | undefined;
+    count?: number | undefined;
+    offset?: number | undefined;
+    safesearch?: "off" | "moderate" | "strict" | undefined;
+    freshness?: string | undefined;
+    searchLang?: string | undefined;
+    uiLang?: string | undefined;
+    extraSnippets?: boolean | undefined;
+    spellcheck?: boolean | undefined;
+    goggles?: string | string[] | undefined;
+    searchType?: "web" | "all" | undefined;
+    fastMode?: boolean | undefined;
+    maxNumResults?: number | undefined;
+    maxPrice?: number | undefined;
+    relevanceThreshold?: number | undefined;
+    responseLength?: number | "max" | "short" | "medium" | "large" | undefined;
+    countryCode?: string | undefined;
+    includedSources?: string[] | undefined;
+    excludedSources?: string[] | undefined;
+    urlOnly?: boolean | undefined;
+    valyuCategory?: string | undefined;
+    isToolCall?: boolean | undefined;
 }>;
 export declare const outputSchema: z.ZodObject<{
     data: z.ZodUnknown;
@@ -207,7 +302,7 @@ export declare const outputSchema: z.ZodObject<{
 export declare const inputJsonSchema: import("../toolUtils.js").JsonSchema;
 export declare const outputJsonSchema: import("../toolUtils.js").JsonSchema;
 export declare const name = "nanogpt_web_search";
-export declare const description = "Search the web using multiple providers. Providers: linkup (default), tavily (AI answers), exa (semantic/neural), kagi (privacy-focused), perplexity (AI-powered). Each provider has unique features - see parameter descriptions.";
+export declare const description = "Search the web using multiple providers. Providers: linkup (default), tavily (AI answers), exa (semantic/neural), kagi (privacy-focused), perplexity (AI-powered), valyu (aggregated), brave (Brave Search API). Each provider has unique features - see parameter descriptions.";
 export declare const annotations: {
     readOnlyHint: boolean;
     openWorldHint: boolean;

package/dist/tools/webSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/tools/webSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2FtB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAGH,eAAO,MAAM,eAAe,sCAA+B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,sCAAgC,CAAC;AAG9D,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,WAAW,uOAC8M,CAAC;AAGvO,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAkCF;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,OAAO;;;GA6H1C"}
+{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/tools/webSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgKtB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAIvB,CAAC;AAGH,eAAO,MAAM,eAAe,sCAA+B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,sCAAgC,CAAC;AAG9D,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,WAAW,qRAC4P,CAAC;AAGrR,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAyCF;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,OAAO;;;GAiK1C"}