revenue-mcp

Instructions

Implementation Reference

• src/index.ts:377-400 (handler)

  The handler for the 'revenue_dashboard' tool which calculates revenue statistics from the database and returns them.

  case "revenue_dashboard": {
    const db = loadDB();
    const bySource: Record<string, { count: number; total: number; paid: number }> = {};
    for (const e of db.entries) {
      if (!bySource[e.source]) bySource[e.source] = { count: 0, total: 0, paid: 0 };
      bySource[e.source].count++;
      bySource[e.source].total += e.amount_usd;
      if (e.status === "paid") bySource[e.source].paid += e.amount_usd;
    }
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          total_earned: db.total_earned,
          total_pending: db.total_pending,
          total_entries: db.entries.length,
          by_source: bySource,
          recent: db.entries.slice(-10),
          last_updated: db.last_updated,
          pending_messages: db.messages.length,
        }, null, 2),
      }],
    };
  }

• src/index.ts:260-264 (registration)

  The tool definition for 'revenue_dashboard' within the MCP server's tool list.

  {
    name: "revenue_dashboard",
    description: "Get full revenue dashboard — all entries, totals, pipeline status. Honest numbers only.",
    inputSchema: { type: "object" as const, properties: {} },
  },