@frase/mcp-server 0.1.0

package/dist/tools/research.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Research tools
+ */
+import { z } from "zod";
+import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
+declare const listResearchInputSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    page_size: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    page_size: number;
+}, {
+    page?: number | undefined;
+    page_size?: number | undefined;
+}>;
+export type ListResearchInput = z.infer<typeof listResearchInputSchema>;
+export declare const listResearchTool: McpToolDefinition;
+export declare function executeListResearch(input: unknown, context: ToolContext): Promise<ToolResult>;
+declare const startResearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    type: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    language: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    query: string;
+    language?: string | undefined;
+    country?: string | undefined;
+}, {
+    query: string;
+    type?: string | undefined;
+    language?: string | undefined;
+    country?: string | undefined;
+}>;
+export type StartResearchInput = z.infer<typeof startResearchInputSchema>;
+export declare const startResearchTool: McpToolDefinition;
+export declare function executeStartResearch(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const researchTools: McpToolDefinition[];
+export declare const researchExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
+export {};
+//# sourceMappingURL=research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/tools/research.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAkC,MAAM,aAAa,CAAC;AAe9G,QAAA,MAAM,uBAAuB;;;;;;;;;EAG3B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,gBAAgB,EAAE,iBAiB9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA0CrB;AAMD,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,EAAE,iBA0B/B,CAAC;AAaF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAMD,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAA0C,CAAC;AAExF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAI9D,CAAC"}

package/dist/tools/research.js

@@ -0,0 +1,151 @@
+/**
+ * Research tools
+ */
+import { z } from "zod";
+import { CACHE_TTL } from "../cache.js";
+import { formatTable, formatStatus, formatDate, formatPagination, formatKeyValue, truncate, } from "../formatter.js";
+// ============================================
+// list_research
+// ============================================
+const listResearchInputSchema = z.object({
+    page: z.number().min(1).optional().default(1),
+    page_size: z.number().min(1).max(100).optional().default(20),
+});
+export const listResearchTool = {
+    name: "list_research",
+    description: "List research sessions in your account. Research provides AI-powered insights on topics.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            page: {
+                type: "number",
+                description: "Page number (default: 1)",
+            },
+            page_size: {
+                type: "number",
+                description: "Items per page, max 100 (default: 20)",
+            },
+        },
+    },
+};
+export async function executeListResearch(input, context) {
+    const parsed = listResearchInputSchema.safeParse(input || {});
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { page, page_size } = parsed.data;
+    try {
+        const response = await context.client.get("/research", { page, page_size }, CACHE_TTL.lists);
+        const headers = ["Query", "Status", "Type", "Language", "Created"];
+        const rows = response.data.map((r) => [
+            truncate(r.query, 40),
+            formatStatus(r.status),
+            r.type || "general",
+            r.language || "-",
+            formatDate(r.created_at),
+        ]);
+        const table = formatTable(headers, rows);
+        const pagination = formatPagination(response.pagination);
+        return {
+            success: true,
+            markdown: `## Research (Page ${page})\n\n${table}${pagination}`,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to list research - ${message}`,
+        };
+    }
+}
+// ============================================
+// start_research
+// ============================================
+const startResearchInputSchema = z.object({
+    query: z.string().min(1).max(500),
+    type: z.string().optional().default("general"),
+    language: z.string().length(2).optional(),
+    country: z.string().length(2).optional(),
+});
+export const startResearchTool = {
+    name: "start_research",
+    description: "Start a new research session on a topic. Returns immediately with a job ID - use get_job_status to check progress.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The topic or question to research (required, max 500 chars)",
+            },
+            type: {
+                type: "string",
+                description: "Type of research (default: general)",
+            },
+            language: {
+                type: "string",
+                description: "Language code (ISO 639-1, e.g., 'en', 'es', 'fr')",
+            },
+            country: {
+                type: "string",
+                description: "Country code (ISO 3166-1, e.g., 'us', 'uk', 'de')",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function executeStartResearch(input, context) {
+    const parsed = startResearchInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const data = parsed.data;
+    try {
+        const response = await context.client.post("/research", {
+            query: data.query,
+            type: data.type,
+            language: data.language,
+            country: data.country,
+        });
+        const research = response.data;
+        let markdown = `## Research Started\n\n`;
+        markdown += formatKeyValue({
+            ID: research.id,
+            Query: research.query,
+            Status: research.status,
+            Type: research.type,
+            Language: research.language,
+            Country: research.country,
+        });
+        markdown += `\n\n**Research is processing.** Check status with:\n`;
+        markdown += `\`get_job_status\` with \`id: "${research.id}"\` and \`type: "research"\``;
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to start research - ${message}`,
+        };
+    }
+}
+// ============================================
+// Export all research tools
+// ============================================
+export const researchTools = [listResearchTool, startResearchTool];
+export const researchExecutors = {
+    list_research: executeListResearch,
+    start_research: executeStartResearch,
+};
+//# sourceMappingURL=research.js.map

package/dist/tools/research.js.map

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

package/dist/tools/serp.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SERP tools
+ *
+ * Search engine results page analysis
+ */
+import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
+export declare const analyzeSerpTool: McpToolDefinition;
+export declare function executeAnalyzeSerp(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const analyzeCompetitorsTool: McpToolDefinition;
+export declare function executeAnalyzeCompetitors(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const getSearchIntentTool: McpToolDefinition;
+export declare function executeGetSearchIntent(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const serpTools: McpToolDefinition[];
+export declare const serpExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
+//# sourceMappingURL=serp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serp.d.ts","sourceRoot":"","sources":["../../src/tools/serp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAEX,MAAM,aAAa,CAAC;AAkErB,eAAO,MAAM,eAAe,EAAE,iBAqB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqErB;AAaD,eAAO,MAAM,sBAAsB,EAAE,iBA0BpC,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmErB;AAUD,eAAO,MAAM,mBAAmB,EAAE,iBAajC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsDrB;AAMD,eAAO,MAAM,SAAS,EAAE,iBAAiB,EAIxC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,CAChC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAK9D,CAAC"}

package/dist/tools/serp.js

@@ -0,0 +1,267 @@
+/**
+ * SERP tools
+ *
+ * Search engine results page analysis
+ */
+import { z } from "zod";
+import { formatTable, formatKeyValue, truncate, } from "../formatter.js";
+// ============================================
+// analyze_serp
+// ============================================
+const analyzeSerpInputSchema = z.object({
+    query: z.string().min(1).max(200),
+    country: z.string().length(2).optional().default("us"),
+    language: z.string().length(2).optional().default("en"),
+});
+export const analyzeSerpTool = {
+    name: "analyze_serp",
+    description: "Analyze search engine results for a query. Returns top results, featured snippets, and related searches.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The search query to analyze (required)",
+            },
+            country: {
+                type: "string",
+                description: "Two-letter country code (default: us)",
+            },
+            language: {
+                type: "string",
+                description: "Two-letter language code (default: en)",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function executeAnalyzeSerp(input, context) {
+    const parsed = analyzeSerpInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { query, country, language } = parsed.data;
+    try {
+        const response = await context.client.post("/serp/analyze", { query, country, language });
+        const data = response.data;
+        let markdown = `## SERP Analysis: ${data.query}\n\n`;
+        if (data.search_intent) {
+            markdown += `**Search Intent:** ${data.search_intent}\n\n`;
+        }
+        if (data.featured_snippet) {
+            markdown += `### Featured Snippet (${data.featured_snippet.type})\n\n`;
+            markdown += `> ${truncate(data.featured_snippet.content, 200)}\n\n`;
+        }
+        markdown += "### Top Results\n\n";
+        if (data.results.length > 0) {
+            const headers = ["Pos", "Domain", "Title"];
+            const rows = data.results.slice(0, 10).map((r) => [
+                r.position.toString(),
+                r.domain,
+                truncate(r.title, 50),
+            ]);
+            markdown += formatTable(headers, rows);
+        }
+        else {
+            markdown += "_No results found._\n";
+        }
+        if (data.people_also_ask.length > 0) {
+            markdown += "\n\n### People Also Ask\n\n";
+            for (const question of data.people_also_ask.slice(0, 5)) {
+                markdown += `- ${question}\n`;
+            }
+        }
+        if (data.related_searches.length > 0) {
+            markdown += "\n\n### Related Searches\n\n";
+            for (const search of data.related_searches.slice(0, 8)) {
+                markdown += `- ${search}\n`;
+            }
+        }
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to analyze SERP - ${message}`,
+        };
+    }
+}
+// ============================================
+// analyze_competitors
+// ============================================
+const analyzeCompetitorsInputSchema = z.object({
+    query: z.string().min(1).max(200),
+    urls: z.array(z.string().url()).optional(),
+    country: z.string().length(2).optional().default("us"),
+    language: z.string().length(2).optional().default("en"),
+});
+export const analyzeCompetitorsTool = {
+    name: "analyze_competitors",
+    description: "Analyze competitor content for a search query. Returns detailed analysis of top-ranking pages.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The search query (required)",
+            },
+            urls: {
+                type: "array",
+                items: { type: "string" },
+                description: "Specific competitor URLs to analyze (optional)",
+            },
+            country: {
+                type: "string",
+                description: "Two-letter country code (default: us)",
+            },
+            language: {
+                type: "string",
+                description: "Two-letter language code (default: en)",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function executeAnalyzeCompetitors(input, context) {
+    const parsed = analyzeCompetitorsInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { query, urls, country, language } = parsed.data;
+    try {
+        const response = await context.client.post("/serp/competitors", { query, urls, country, language });
+        const data = response.data;
+        let markdown = `## Competitor Analysis: ${data.query}\n\n`;
+        if (data.competitors.length === 0) {
+            return {
+                success: true,
+                markdown: markdown + "_No competitor data available._",
+                data: response,
+            };
+        }
+        for (const comp of data.competitors.slice(0, 5)) {
+            markdown += `### #${comp.position}: ${comp.domain}\n\n`;
+            markdown += formatKeyValue({
+                url: truncate(comp.url, 60),
+                title: truncate(comp.title, 50),
+                word_count: comp.word_count,
+                content_type: comp.content_type,
+            });
+            if (comp.strengths.length > 0) {
+                markdown += "\n\n**Strengths:**\n";
+                for (const s of comp.strengths.slice(0, 3)) {
+                    markdown += `- ${s}\n`;
+                }
+            }
+            if (comp.weaknesses.length > 0) {
+                markdown += "\n**Weaknesses:**\n";
+                for (const w of comp.weaknesses.slice(0, 3)) {
+                    markdown += `- ${w}\n`;
+                }
+            }
+            markdown += "\n---\n\n";
+        }
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to analyze competitors - ${message}`,
+        };
+    }
+}
+// ============================================
+// get_search_intent
+// ============================================
+const getSearchIntentInputSchema = z.object({
+    query: z.string().min(1).max(200),
+});
+export const getSearchIntentTool = {
+    name: "get_search_intent",
+    description: "Analyze the search intent behind a query. Returns intent classification and content recommendations.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The search query to analyze (required)",
+            },
+        },
+        required: ["query"],
+    },
+};
+export async function executeGetSearchIntent(input, context) {
+    const parsed = getSearchIntentInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { query } = parsed.data;
+    try {
+        const response = await context.client.post("/serp/intent", { query });
+        const data = response.data;
+        let markdown = `## Search Intent Analysis: ${data.query}\n\n`;
+        markdown += formatKeyValue({
+            primary_intent: data.primary_intent,
+            confidence: `${(data.confidence * 100).toFixed(0)}%`,
+            recommended_content_type: data.recommended_content_type,
+            recommended_format: data.recommended_format,
+        });
+        if (data.secondary_intents.length > 0) {
+            markdown += "\n\n### Secondary Intents\n\n";
+            for (const intent of data.secondary_intents) {
+                markdown += `- ${intent}\n`;
+            }
+        }
+        if (data.key_topics.length > 0) {
+            markdown += "\n\n### Key Topics to Cover\n\n";
+            for (const topic of data.key_topics) {
+                markdown += `- ${topic}\n`;
+            }
+        }
+        return {
+            success: true,
+            markdown,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to analyze search intent - ${message}`,
+        };
+    }
+}
+// ============================================
+// Export all
+// ============================================
+export const serpTools = [
+    analyzeSerpTool,
+    analyzeCompetitorsTool,
+    getSearchIntentTool,
+];
+export const serpExecutors = {
+    analyze_serp: executeAnalyzeSerp,
+    analyze_competitors: executeAnalyzeCompetitors,
+    get_search_intent: executeGetSearchIntent,
+};
+//# sourceMappingURL=serp.js.map

package/dist/tools/serp.js.map

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

package/dist/tools/sites.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Sites tools
+ */
+import { z } from "zod";
+import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
+/**
+ * Input schema for list_sites
+ */
+declare const listSitesInputSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    page_size: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    page_size: number;
+}, {
+    page?: number | undefined;
+    page_size?: number | undefined;
+}>;
+export type ListSitesInput = z.infer<typeof listSitesInputSchema>;
+/**
+ * Tool definition for list_sites
+ */
+export declare const listSitesTool: McpToolDefinition;
+/**
+ * Execute list_sites
+ */
+export declare function executeListSites(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const siteTools: McpToolDefinition[];
+export declare const siteExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
+export {};
+//# sourceMappingURL=sites.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../src/tools/sites.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAA8B,MAAM,aAAa,CAAC;AAQ1G;;GAEG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;EAGxB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,iBAiB3B,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA2CrB;AAMD,eAAO,MAAM,SAAS,EAAE,iBAAiB,EAAoB,CAAC;AAE9D,eAAO,MAAM,aAAa,EAAE,MAAM,CAChC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAG9D,CAAC"}

package/dist/tools/sites.js

@@ -0,0 +1,83 @@
+/**
+ * Sites tools
+ */
+import { z } from "zod";
+import { CACHE_TTL } from "../cache.js";
+import { formatTable, formatDate, formatPagination } from "../formatter.js";
+// ============================================
+// list_sites
+// ============================================
+/**
+ * Input schema for list_sites
+ */
+const listSitesInputSchema = z.object({
+    page: z.number().min(1).optional().default(1),
+    page_size: z.number().min(1).max(100).optional().default(20),
+});
+/**
+ * Tool definition for list_sites
+ */
+export const listSitesTool = {
+    name: "list_sites",
+    description: "List all sites in your Frase account. Sites are domains you've connected for SEO tracking and content optimization.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            page: {
+                type: "number",
+                description: "Page number (default: 1)",
+            },
+            page_size: {
+                type: "number",
+                description: "Items per page, max 100 (default: 20)",
+            },
+        },
+    },
+};
+/**
+ * Execute list_sites
+ */
+export async function executeListSites(input, context) {
+    // Validate input
+    const parsed = listSitesInputSchema.safeParse(input || {});
+    if (!parsed.success) {
+        return {
+            success: false,
+            markdown: `**Error:** Invalid input - ${parsed.error.message}`,
+        };
+    }
+    const { page, page_size } = parsed.data;
+    try {
+        const response = await context.client.get("/sites", { page, page_size }, CACHE_TTL.lists);
+        // Format as markdown table
+        const headers = ["Name", "Domain", "GSC", "Created"];
+        const rows = response.data.map((site) => [
+            site.name,
+            site.domain,
+            site.gsc_connected ? "✅" : "❌",
+            formatDate(site.created_at),
+        ]);
+        const table = formatTable(headers, rows);
+        const pagination = formatPagination(response.pagination);
+        return {
+            success: true,
+            markdown: `## Sites (Page ${page})\n\n${table}${pagination}`,
+            data: response,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return {
+            success: false,
+            markdown: `**Error:** Failed to list sites - ${message}`,
+        };
+    }
+}
+// ============================================
+// Export all site tools
+// ============================================
+export const siteTools = [listSitesTool];
+export const siteExecutors = {
+    list_sites: executeListSites,
+};
+//# sourceMappingURL=sites.js.map

package/dist/tools/sites.js.map

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

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Webhook tools
+ *
+ * Manage webhooks for event notifications
+ */
+import type { McpToolDefinition, ToolContext, ToolResult } from "../types.js";
+export declare const listWebhooksTool: McpToolDefinition;
+export declare function executeListWebhooks(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const createWebhookTool: McpToolDefinition;
+export declare function executeCreateWebhook(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const getWebhookTool: McpToolDefinition;
+export declare function executeGetWebhook(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const updateWebhookTool: McpToolDefinition;
+export declare function executeUpdateWebhook(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const deleteWebhookTool: McpToolDefinition;
+export declare function executeDeleteWebhook(input: unknown, context: ToolContext): Promise<ToolResult>;
+export declare const webhookTools: McpToolDefinition[];
+export declare const webhookExecutors: Record<string, (input: unknown, context: ToolContext) => Promise<ToolResult>>;
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAkDrB,eAAO,MAAM,gBAAgB,EAAE,iBAgB9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA0CrB;AAaD,eAAO,MAAM,iBAAiB,EAAE,iBA6B/B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAUD,eAAO,MAAM,cAAc,EAAE,iBAa5B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA+CrB;AAcD,eAAO,MAAM,iBAAiB,EAAE,iBAkC/B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAUD,eAAO,MAAM,iBAAiB,EAAE,iBAa/B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAMD,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAM3C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAO9D,CAAC"}