@reaudit/mcp-server 1.0.0

package/dist/tools/usage.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Usage Tools
+ *
+ * MCP tools for tracking token usage and managing budgets.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usageTools = exports.setBudgetLimitsSchema = exports.getBudgetStatusSchema = exports.getTokenUsageSchema = void 0;
+exports.getTokenUsage = getTokenUsage;
+exports.getBudgetStatus = getBudgetStatus;
+exports.setBudgetLimits = setBudgetLimits;
+const zod_1 = require("zod");
+// Schemas
+exports.getTokenUsageSchema = zod_1.z.object({
+    days: zod_1.z.number().min(1).max(90).optional().describe('Number of days to include (default: 30, max: 90)'),
+});
+exports.getBudgetStatusSchema = zod_1.z.object({});
+exports.setBudgetLimitsSchema = zod_1.z.object({
+    monthlyTokenLimit: zod_1.z.number().nullable().optional().describe('Monthly token limit (null for unlimited)'),
+    monthlyCostLimit: zod_1.z.number().nullable().optional().describe('Monthly cost limit in dollars (null for unlimited)'),
+    alertThreshold: zod_1.z.number().min(0).max(100).optional().describe('Alert threshold percentage (default: 80)'),
+    pauseOnLimit: zod_1.z.boolean().optional().describe('Pause operations when limit reached'),
+});
+/**
+ * Get token usage summary
+ */
+async function getTokenUsage(client, args) {
+    const data = await client.getTokenUsage(args.days);
+    let output = `## Token Usage Summary (${data.period})\n\n`;
+    output += `**Total Tokens:** ${data.totalTokens.toLocaleString()}\n`;
+    output += `**Total Cost:** ${data.totalCostFormatted}\n\n`;
+    if (data.budget) {
+        output += `### Budget Status\n`;
+        if (data.budget.tokenLimit) {
+            output += `- Token Limit: ${data.budget.tokenLimit.toLocaleString()}\n`;
+        }
+        if (data.budget.costLimit) {
+            output += `- Cost Limit: $${(data.budget.costLimit / 100).toFixed(2)}\n`;
+        }
+        output += `- Usage: ${data.budget.percentUsed}%\n\n`;
+    }
+    if (data.byOperation && data.byOperation.length > 0) {
+        output += `### Usage by Operation\n`;
+        output += `| Operation | Tokens | Cost | Count |\n`;
+        output += `|-----------|--------|------|-------|\n`;
+        for (const op of data.byOperation.slice(0, 10)) {
+            output += `| ${op.operation} | ${op.tokens.toLocaleString()} | $${(op.cost / 100).toFixed(2)} | ${op.count} |\n`;
+        }
+        output += '\n';
+    }
+    if (data.byDay && data.byDay.length > 0) {
+        output += `### Recent Daily Usage\n`;
+        for (const day of data.byDay.slice(-7)) {
+            output += `- ${day.date}: ${day.tokens.toLocaleString()} tokens ($${(day.cost / 100).toFixed(2)})\n`;
+        }
+    }
+    return output;
+}
+/**
+ * Get budget status
+ */
+async function getBudgetStatus(client, _args) {
+    const data = await client.getBudgetStatus();
+    let output = `## Budget Status\n\n`;
+    if (!data.hasLimits) {
+        output += `No budget limits configured. Usage is unlimited.\n\n`;
+        output += `To set limits, use the \`set_budget_limits\` tool.\n`;
+        return output;
+    }
+    if (data.settings) {
+        output += `### Current Settings\n`;
+        if (data.settings.monthlyTokenLimit) {
+            output += `- Monthly Token Limit: ${data.settings.monthlyTokenLimit.toLocaleString()}\n`;
+        }
+        if (data.settings.monthlyCostLimitFormatted) {
+            output += `- Monthly Cost Limit: ${data.settings.monthlyCostLimitFormatted}\n`;
+        }
+        output += `- Alert Threshold: ${data.settings.alertThreshold}%\n`;
+        output += `- Pause on Limit: ${data.settings.pauseOnLimit ? 'Yes' : 'No'}\n`;
+        output += `- Notify on Alert: ${data.settings.notifyOnAlert ? 'Yes' : 'No'}\n\n`;
+    }
+    if (data.usage) {
+        output += `### Current Usage (${data.currentPeriod})\n`;
+        output += `- Tokens Used: ${data.usage.tokens.toLocaleString()}`;
+        if (data.usage.tokenLimit) {
+            output += ` / ${data.usage.tokenLimit.toLocaleString()}`;
+        }
+        output += '\n';
+        output += `- Cost: ${data.usage.costFormatted}`;
+        if (data.usage.costLimit) {
+            output += ` / $${(data.usage.costLimit / 100).toFixed(2)}`;
+        }
+        output += '\n';
+        output += `- Usage: ${data.usage.percentUsed}%\n\n`;
+    }
+    output += `### Status\n`;
+    if (data.status.limitReached) {
+        output += `⚠️ **Limit Reached**`;
+        if (data.status.reason) {
+            output += `: ${data.status.reason}`;
+        }
+        output += '\n';
+    }
+    else if (data.status.alertSent) {
+        output += `⚠️ Alert threshold reached\n`;
+    }
+    else {
+        output += `✅ Within budget\n`;
+    }
+    return output;
+}
+/**
+ * Set budget limits
+ */
+async function setBudgetLimits(client, args) {
+    await client.updateBudgetSettings(args);
+    let output = `## Budget Settings Updated\n\n`;
+    if ('monthlyTokenLimit' in args) {
+        output += `- Monthly Token Limit: ${args.monthlyTokenLimit === null ? 'Unlimited' : args.monthlyTokenLimit?.toLocaleString()}\n`;
+    }
+    if ('monthlyCostLimit' in args) {
+        output += `- Monthly Cost Limit: ${args.monthlyCostLimit === null ? 'Unlimited' : `$${args.monthlyCostLimit?.toFixed(2)}`}\n`;
+    }
+    if ('alertThreshold' in args) {
+        output += `- Alert Threshold: ${args.alertThreshold}%\n`;
+    }
+    if ('pauseOnLimit' in args) {
+        output += `- Pause on Limit: ${args.pauseOnLimit ? 'Yes' : 'No'}\n`;
+    }
+    output += `\nUse \`get_budget_status\` to view your current budget status.`;
+    return output;
+}
+// Tool definitions
+exports.usageTools = [
+    {
+        name: 'get_token_usage',
+        description: 'Get a summary of your LLM token usage and costs over a specified period',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                days: {
+                    type: 'number',
+                    description: 'Number of days to include (default: 30, max: 90)',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_budget_status',
+        description: 'Get your current budget limits and usage status',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'set_budget_limits',
+        description: 'Set monthly budget limits for token usage and costs. Set to null to remove limits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                monthlyTokenLimit: {
+                    type: ['number', 'null'],
+                    description: 'Monthly token limit (null for unlimited)',
+                },
+                monthlyCostLimit: {
+                    type: ['number', 'null'],
+                    description: 'Monthly cost limit in dollars (null for unlimited)',
+                },
+                alertThreshold: {
+                    type: 'number',
+                    description: 'Alert threshold percentage (default: 80)',
+                    minimum: 0,
+                    maximum: 100,
+                },
+                pauseOnLimit: {
+                    type: 'boolean',
+                    description: 'Pause operations when limit reached',
+                },
+            },
+        },
+    },
+];
+//# sourceMappingURL=usage.js.map

package/dist/tools/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAsBH,sCAwCC;AAKD,0CAwDC;AAKD,0CAwBC;AAtJD,6BAAwB;AAGxB,UAAU;AACG,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACxG,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErC,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACxG,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACjH,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC1G,YAAY,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACrF,CAAC,CAAC;AAEH;;GAEG;AACI,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,IAAyC;IAEzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,MAAM,GAAG,2BAA2B,IAAI,CAAC,MAAM,OAAO,CAAC;IAC3D,MAAM,IAAI,qBAAqB,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC;IACrE,MAAM,IAAI,mBAAmB,IAAI,CAAC,kBAAkB,MAAM,CAAC;IAE3D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,IAAI,qBAAqB,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,CAAC;QACD,MAAM,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,WAAW,OAAO,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,0BAA0B,CAAC;QACrC,MAAM,IAAI,yCAAyC,CAAC;QACpD,MAAM,IAAI,yCAAyC,CAAC;QAEpD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;QACnH,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,0BAA0B,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACvG,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,KAA4C;IAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;IAE5C,IAAI,MAAM,GAAG,sBAAsB,CAAC;IAEpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,sDAAsD,CAAC;QACjE,MAAM,IAAI,sDAAsD,CAAC;QACjE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,wBAAwB,CAAC;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACpC,MAAM,IAAI,0BAA0B,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,cAAc,EAAE,IAAI,CAAC;QAC3F,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE,CAAC;YAC5C,MAAM,IAAI,yBAAyB,IAAI,CAAC,QAAQ,CAAC,yBAAyB,IAAI,CAAC;QACjF,CAAC;QACD,MAAM,IAAI,sBAAsB,IAAI,CAAC,QAAQ,CAAC,cAAc,KAAK,CAAC;QAClE,MAAM,IAAI,qBAAqB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC7E,MAAM,IAAI,sBAAsB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACnF,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,sBAAsB,IAAI,CAAC,aAAa,KAAK,CAAC;QACxD,MAAM,IAAI,kBAAkB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;QAC3D,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;QACf,MAAM,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;QACf,MAAM,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,cAAc,CAAC;IACzB,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7B,MAAM,IAAI,sBAAsB,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;IACjB,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,8BAA8B,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,mBAAmB,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,IAA2C;IAE3C,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,MAAM,GAAG,gCAAgC,CAAC;IAE9C,IAAI,mBAAmB,IAAI,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,0BAA0B,IAAI,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC;IACnI,CAAC;IACD,IAAI,kBAAkB,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,yBAAyB,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAChI,CAAC;IACD,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,sBAAsB,IAAI,CAAC,cAAc,KAAK,CAAC;IAC3D,CAAC;IACD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,qBAAqB,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACtE,CAAC;IAED,MAAM,IAAI,iEAAiE,CAAC;IAE5E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mBAAmB;AACN,QAAA,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,oFAAoF;QACjG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,iBAAiB,EAAE;oBACjB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxB,WAAW,EAAE,0CAA0C;iBACxD;gBACD,gBAAgB,EAAE;oBAChB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxB,WAAW,EAAE,oDAAoD;iBAClE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;oBACvD,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;iBACb;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,qCAAqC;iBACnD;aACF;SACF;KACF;CACF,CAAC"}

package/dist/tools/visibility.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Visibility Tools
+ *
+ * MCP tools for AI visibility tracking and analysis.
+ */
+import { z } from 'zod';
+import { ReauditAPIClient } from '../lib/api-client.js';
+export declare const getVisibilityScoreSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export declare const getBrandMentionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    platform: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    days: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    platform?: string | undefined;
+    limit?: number | undefined;
+    days?: number | undefined;
+}, {
+    projectId: string;
+    platform?: string | undefined;
+    limit?: number | undefined;
+    days?: number | undefined;
+}>;
+export declare const getCompetitorComparisonSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+/**
+ * Get visibility score tool handler
+ */
+export declare function getVisibilityScore(client: ReauditAPIClient, args: z.infer<typeof getVisibilityScoreSchema>): Promise<string>;
+/**
+ * Get brand mentions tool handler
+ */
+export declare function getBrandMentions(client: ReauditAPIClient, args: z.infer<typeof getBrandMentionsSchema>): Promise<string>;
+/**
+ * Get competitor comparison tool handler
+ */
+export declare function getCompetitorComparison(client: ReauditAPIClient, args: z.infer<typeof getCompetitorComparisonSchema>): Promise<string>;
+/**
+ * Tool definitions for MCP
+ */
+export declare const visibilityTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
+            platform?: undefined;
+            limit?: undefined;
+            days?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectId: {
+                type: string;
+                description: string;
+            };
+            platform: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            days: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=visibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/tools/visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;EAExC,CAAC;AAEH;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,GAC7C,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuD3B,CAAC"}

package/dist/tools/visibility.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Visibility Tools
+ *
+ * MCP tools for AI visibility tracking and analysis.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.visibilityTools = exports.getCompetitorComparisonSchema = exports.getBrandMentionsSchema = exports.getVisibilityScoreSchema = void 0;
+exports.getVisibilityScore = getVisibilityScore;
+exports.getBrandMentions = getBrandMentions;
+exports.getCompetitorComparison = getCompetitorComparison;
+const zod_1 = require("zod");
+// Tool schemas
+exports.getVisibilityScoreSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('The ID of the project to get visibility score for'),
+});
+exports.getBrandMentionsSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('The ID of the project'),
+    platform: zod_1.z.string().optional().describe('Filter by platform (chatgpt, claude, perplexity, etc.)'),
+    limit: zod_1.z.number().optional().describe('Maximum number of mentions to return (default: 20, max: 50)'),
+    days: zod_1.z.number().optional().describe('Number of days to look back (default: 30, max: 90)'),
+});
+exports.getCompetitorComparisonSchema = zod_1.z.object({
+    projectId: zod_1.z.string().describe('The ID of the project to compare'),
+});
+/**
+ * Get visibility score tool handler
+ */
+async function getVisibilityScore(client, args) {
+    const result = await client.getVisibilityScore(args.projectId);
+    let response = `## AI Visibility Score for ${result.brandName}\n\n`;
+    response += `**Overall Score:** ${result.visibilityScore}/100\n`;
+    response += `**Period:** Last ${result.period}\n\n`;
+    response += `### Key Metrics\n`;
+    response += `- Total Mentions: ${result.metrics.totalMentions}\n`;
+    response += `- Citations Received: ${result.metrics.citationsReceived}\n`;
+    response += `- Citation Rate: ${result.metrics.citationRate}%\n`;
+    response += `- Average Sentiment: ${result.metrics.avgSentiment}/100\n\n`;
+    if (result.platformBreakdown.length > 0) {
+        response += `### Platform Breakdown\n`;
+        for (const platform of result.platformBreakdown) {
+            response += `- **${platform.platform}**: ${platform.mentions} mentions (sentiment: ${platform.avgSentiment})\n`;
+        }
+        response += '\n';
+    }
+    response += `### Sentiment Distribution\n`;
+    response += `- Positive: ${result.sentimentDistribution.positive}\n`;
+    response += `- Neutral: ${result.sentimentDistribution.neutral}\n`;
+    response += `- Negative: ${result.sentimentDistribution.negative}\n`;
+    return response;
+}
+/**
+ * Get brand mentions tool handler
+ */
+async function getBrandMentions(client, args) {
+    const result = await client.getBrandMentions(args.projectId, {
+        platform: args.platform,
+        limit: args.limit,
+        days: args.days,
+    });
+    if (result.mentions.length === 0) {
+        return `No brand mentions found for ${result.brandName} in the last ${result.period}.`;
+    }
+    let response = `## Brand Mentions for ${result.brandName}\n`;
+    response += `Found ${result.count} mentions in the last ${result.period}\n\n`;
+    for (const mention of result.mentions) {
+        const sentimentEmoji = mention.sentimentLabel === 'positive' ? '✅' :
+            mention.sentimentLabel === 'negative' ? '❌' : '➖';
+        response += `### ${mention.platform} ${sentimentEmoji}\n`;
+        response += `**Prompt:** ${mention.prompt}\n`;
+        response += `**Excerpt:** ${mention.excerpt}\n`;
+        response += `**Sentiment:** ${mention.sentimentLabel} (${mention.sentiment}/100)\n`;
+        if (mention.citationCount > 0) {
+            response += `**Citations:** ${mention.citationCount}\n`;
+        }
+        response += `**Date:** ${new Date(mention.timestamp).toLocaleDateString()}\n\n`;
+    }
+    return response;
+}
+/**
+ * Get competitor comparison tool handler
+ */
+async function getCompetitorComparison(client, args) {
+    const result = await client.getCompetitorComparison(args.projectId);
+    if (result.competitors.length === 0) {
+        return `No competitors configured for ${result.brandName}. Add competitors in the Reaudit dashboard to enable comparison.`;
+    }
+    let response = `## Competitor Comparison for ${result.brandName}\n`;
+    response += `Period: Last ${result.period}\n\n`;
+    response += `### Your Performance\n`;
+    response += `- **Rank:** #${result.yourMetrics.rank} of ${result.yourMetrics.totalCompetitors + 1}\n`;
+    response += `- **Mentions:** ${result.yourMetrics.mentions}\n`;
+    response += `- **Avg Sentiment:** ${result.yourMetrics.avgSentiment}/100\n`;
+    response += `- **Citations:** ${result.yourMetrics.citations}\n\n`;
+    response += `### Competitors\n`;
+    for (const comp of result.competitors) {
+        response += `**${comp.name}** (${comp.domain})\n`;
+        response += `- Mentions: ${comp.mentions}\n`;
+        response += `- Sentiment: ${comp.avgSentiment}/100\n`;
+        response += `- Citations: ${comp.citations}\n\n`;
+    }
+    return response;
+}
+/**
+ * Tool definitions for MCP
+ */
+exports.visibilityTools = [
+    {
+        name: 'get_visibility_score',
+        description: 'Get the AI visibility score for a project. Shows how often your brand is mentioned by AI assistants, citation rates, and sentiment analysis.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'The ID of the project to get visibility score for',
+                },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_brand_mentions',
+        description: 'Get recent brand mentions across AI platforms like ChatGPT, Claude, and Perplexity. Shows the prompts that triggered mentions and sentiment analysis.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'The ID of the project',
+                },
+                platform: {
+                    type: 'string',
+                    description: 'Filter by platform (chatgpt, claude, perplexity, etc.)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of mentions to return (default: 20, max: 50)',
+                },
+                days: {
+                    type: 'number',
+                    description: 'Number of days to look back (default: 30, max: 90)',
+                },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'get_competitor_comparison',
+        description: 'Compare your AI visibility with competitors. Shows ranking, mention counts, and sentiment comparison.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'The ID of the project to compare',
+                },
+            },
+            required: ['projectId'],
+        },
+    },
+];
+//# sourceMappingURL=visibility.js.map

package/dist/tools/visibility.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@reaudit/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Reaudit AI Visibility Platform - Access your AI visibility data from Claude, Cursor, and other AI assistants",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "reaudit-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "jest"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "reaudit",
+    "ai-visibility",
+    "seo",
+    "claude",
+    "cursor",
+    "ai-assistant"
+  ],
+  "author": "Reaudit <support@reaudit.io>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RoseSamaras/reaudit-mcp-server"
+  },
+  "homepage": "https://reaudit.io/docs/mcp",
+  "bugs": {
+    "url": "https://github.com/RoseSamaras/reaudit-mcp-server/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}