volthq-mcp-server

Instructions

Implementation Reference

• packages/mcp-server/src/tools/set-budget-alert.ts:24-59 (handler)

  The handler function for 'volt_set_budget_alert' that interacts with the SpendTracker.

  export function handleSetBudgetAlert(input: SetBudgetAlertInput, tracker: SpendTracker) {
    const alert = tracker.setAlert(input.threshold, input.period);
    const allAlerts = tracker.getAlerts();
    const triggered = tracker.checkAlerts();
  
    const lines: string[] = [
      `Budget alert configured`,
      '─'.repeat(60),
      `Period: ${alert.period}`,
      `Threshold: $${alert.threshold.toFixed(2)}`,
      `Status: ${alert.enabled ? 'enabled' : 'disabled'}`,
    ];
  
    if (triggered.length > 0) {
      lines.push('', 'Active alerts:');
      for (const t of triggered) {
        lines.push(`  ${t.message}`);
      }
    }
  
    if (allAlerts.length > 1) {
      lines.push('', 'All configured alerts:');
      for (const a of allAlerts) {
        lines.push(`  ${a.period}: $${a.threshold.toFixed(2)} (${a.enabled ? 'on' : 'off'})`);
      }
    }
  
    return {
      content: [
        {
          type: 'text' as const,
          text: lines.join('\n'),
        },
      ],
    };
  }

• packages/mcp-server/src/tools/set-budget-alert.ts:12-20 (schema)

  Input validation schema for 'volt_set_budget_alert'.

  export const setBudgetAlertSchema = z.object({
    threshold: z
      .number()
      .positive()
      .describe('Budget threshold in USD (e.g. 10.00 for $10)'),
    period: z
      .enum(['daily', 'weekly', 'monthly'])
      .describe('Budget period: daily, weekly, or monthly'),
  });

• packages/mcp-server/src/index.ts:178-184 (registration)

  Tool registration for 'volt_set_budget_alert' in the MCP server.

  // ── volt_set_budget_alert ─────────────────────────────
  server.tool(
    'volt_set_budget_alert',
    'Set a budget threshold for daily, weekly, or monthly spend. Alerts when exceeded.',
    setBudgetAlertSchema.shape,
    async (input) => maybeAddFirstRun(handleSetBudgetAlert(setBudgetAlertSchema.parse(input), spendTracker)),
  );