mcp-supabase-crm-biancode 1.0.0

package/.env.example

@@ -0,0 +1 @@
+SUPABASE_CRM_API_TOKEN=your_api_token_here

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * HTTP client for CRM Biancode Edge Functions (list-sellers, create-sale).
+ * Auth via x-api-token header.
+ */
+export interface Seller {
+    id: string;
+    name: string;
+    role: string;
+    email?: string | null;
+    phone?: string | null;
+    commission_percentage?: number;
+}
+export interface ListSellersResponse {
+    sellers: Seller[];
+}
+export interface CreateSaleBody {
+    client_id: string;
+    title: string;
+    total_amount: number;
+    sale_date: string;
+    description?: string;
+    installments?: number;
+    due_day?: number;
+    installment_start_date?: string;
+    status?: string;
+    goal_id?: string;
+    tax_percentage?: number;
+    gateway_fee_percentage?: number;
+    sellers?: Array<{
+        seller_id: string;
+        commission_amount: number;
+    }>;
+}
+export interface CreateSaleResponse {
+    success: boolean;
+    sale_id: string;
+    installments_created: number;
+    receivables_created: number;
+    sellers_linked: number;
+}
+export declare function getSellers(): Promise<ListSellersResponse>;
+export declare function createSale(body: CreateSaleBody): Promise<CreateSaleResponse>;

package/dist/client.js

@@ -0,0 +1,66 @@
+/**
+ * HTTP client for CRM Biancode Edge Functions (list-sellers, create-sale).
+ * Auth via x-api-token header.
+ */
+import pRetry from "p-retry";
+import { fetch as undiciFetch } from "undici";
+const BASE_URL = "https://pxfjpxepjcvuiftbztar.supabase.co/functions/v1";
+const REQUEST_TIMEOUT_MS = 15_000;
+function getConfig() {
+    const token = process.env.SUPABASE_CRM_API_TOKEN;
+    if (!token) {
+        throw new Error("SUPABASE_CRM_API_TOKEN is required");
+    }
+    return { token };
+}
+function headers(token) {
+    return {
+        "x-api-token": token,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+}
+async function request(path, token, options = {}) {
+    const run = async () => {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            const res = await undiciFetch(`${BASE_URL}${path}`, {
+                method: options.method ?? "GET",
+                headers: headers(token),
+                body: options.body,
+                signal: ac.signal,
+            });
+            if (res.status === 429 || (res.status >= 500 && res.status < 600)) {
+                throw new Error(`HTTP ${res.status}`);
+            }
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`CRM API ${res.status}: ${text.slice(0, 300)}`);
+            }
+            return res.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+    return pRetry(run, {
+        retries: 3,
+        onFailedAttempt: (e) => {
+            if (e.retriesLeft > 0) {
+                console.error(`[supabase-crm] Retry after ${e.message}`);
+            }
+        },
+    });
+}
+export async function getSellers() {
+    const { token } = getConfig();
+    return request("/list-sellers", token);
+}
+export async function createSale(body) {
+    const { token } = getConfig();
+    return request("/create-sale", token, {
+        method: "POST",
+        body: JSON.stringify(body),
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "node:http";
+import { sellersList } from "./tools/sellers.js";
+import { createSaleTool } from "./tools/sales.js";
+import * as schemas from "./schemas/inputs.js";
+function safe(name, fn) {
+    return async (args) => {
+        try {
+            return await fn(args);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.error(`[mcp-supabase-crm-biancode] ${name} failed: ${msg}`);
+            return { content: [{ type: "text", text: JSON.stringify({ error: msg }) }] };
+        }
+    };
+}
+const server = new McpServer({
+    name: "supabase-crm-biancode",
+    version: "1.0.0",
+});
+server.registerTool("sellers_list", {
+    title: "List sellers",
+    description: "Lista vendedores cadastrados no CRM. Use para obter os IDs ao cadastrar uma venda e escolher quem participou (comissao).",
+    inputSchema: schemas.sellersListSchema,
+}, safe("sellers_list", (a) => sellersList(a)));
+server.registerTool("create_sale", {
+    title: "Create sale",
+    description: "Cadastra nova venda no CRM. Insere em sales, sale_installments, accounts_receivable e sale_sellers. Chame sellers_list antes para obter IDs dos vendedores.",
+    inputSchema: schemas.createSaleSchema,
+}, safe("create_sale", (a) => createSaleTool(a)));
+const port = parseInt(process.env.MCP_PORT ?? "", 10);
+if (port > 0) {
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    const httpServer = createServer((req, res) => {
+        if (req.url === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok" }));
+            return;
+        }
+        transport.handleRequest(req, res);
+    });
+    await server.connect(transport);
+    httpServer.listen(port, () => {
+        console.error(`[mcp-supabase-crm-biancode] HTTP transport listening on port ${port}`);
+    });
+}
+else {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}

package/dist/schemas/inputs.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+export declare const sellersListSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const sellerEntrySchema: z.ZodObject<{
+    seller_id: z.ZodString;
+    commission_amount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    seller_id: string;
+    commission_amount: number;
+}, {
+    seller_id: string;
+    commission_amount: number;
+}>;
+export declare const createSaleSchema: z.ZodObject<{
+    client_id: z.ZodString;
+    title: z.ZodString;
+    total_amount: z.ZodNumber;
+    sale_date: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    installments: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    due_day: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    installment_start_date: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    goal_id: z.ZodOptional<z.ZodString>;
+    tax_percentage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    gateway_fee_percentage: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sellers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seller_id: z.ZodString;
+        commission_amount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        seller_id: string;
+        commission_amount: number;
+    }, {
+        seller_id: string;
+        commission_amount: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    client_id: string;
+    title: string;
+    total_amount: number;
+    sale_date: string;
+    installments: number;
+    due_day: number;
+    tax_percentage: number;
+    gateway_fee_percentage: number;
+    description?: string | undefined;
+    installment_start_date?: string | undefined;
+    goal_id?: string | undefined;
+    sellers?: {
+        seller_id: string;
+        commission_amount: number;
+    }[] | undefined;
+}, {
+    client_id: string;
+    title: string;
+    total_amount: number;
+    sale_date: string;
+    status?: string | undefined;
+    description?: string | undefined;
+    installments?: number | undefined;
+    due_day?: number | undefined;
+    installment_start_date?: string | undefined;
+    goal_id?: string | undefined;
+    tax_percentage?: number | undefined;
+    gateway_fee_percentage?: number | undefined;
+    sellers?: {
+        seller_id: string;
+        commission_amount: number;
+    }[] | undefined;
+}>;

package/dist/schemas/inputs.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+const dateStr = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Formato YYYY-MM-DD");
+export const sellersListSchema = z.object({});
+export const sellerEntrySchema = z.object({
+    seller_id: z.string().uuid().describe("UUID do vendedor (use sellers_list para obter os IDs)"),
+    commission_amount: z.number().min(0).describe("Valor da comissao em reais (total da venda)"),
+});
+export const createSaleSchema = z.object({
+    client_id: z.string().uuid().describe("UUID do cliente no CRM"),
+    title: z.string().min(1).describe("Nome/titulo da venda"),
+    total_amount: z.number().positive().describe("Valor total da venda em reais"),
+    sale_date: dateStr.describe("Data da venda (YYYY-MM-DD)"),
+    description: z.string().optional().describe("Descricao opcional"),
+    installments: z.number().int().min(1).max(24).optional().default(1).describe("Numero de parcelas"),
+    due_day: z.number().int().min(1).max(28).optional().default(15).describe("Dia do vencimento de cada parcela"),
+    installment_start_date: dateStr.optional().describe("Data da primeira parcela (YYYY-MM-DD)"),
+    status: z.string().optional().default("pending").describe("Status da venda"),
+    goal_id: z.string().uuid().optional().describe("UUID da meta associada"),
+    tax_percentage: z.number().min(0).max(100).optional().default(0).describe("Percentual de imposto"),
+    gateway_fee_percentage: z.number().min(0).max(100).optional().default(0).describe("Percentual de taxa gateway"),
+    sellers: z
+        .array(sellerEntrySchema)
+        .optional()
+        .describe("Vendedores que participaram da venda e suas comissoes (use sellers_list para obter IDs)"),
+});

package/dist/tools/sales.d.ts

@@ -0,0 +1,10 @@
+import type { z } from "zod";
+import type { createSaleSchema } from "../schemas/inputs.js";
+type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare function createSaleTool(args: z.infer<typeof createSaleSchema>): Promise<ToolResult>;
+export {};

package/dist/tools/sales.js

@@ -0,0 +1,23 @@
+import { createSale } from "../client.js";
+function text(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+export async function createSaleTool(args) {
+    const body = {
+        client_id: args.client_id,
+        title: args.title,
+        total_amount: args.total_amount,
+        sale_date: args.sale_date,
+        description: args.description,
+        installments: args.installments,
+        due_day: args.due_day,
+        installment_start_date: args.installment_start_date,
+        status: args.status,
+        goal_id: args.goal_id,
+        tax_percentage: args.tax_percentage,
+        gateway_fee_percentage: args.gateway_fee_percentage,
+        sellers: args.sellers,
+    };
+    const result = await createSale(body);
+    return text(result);
+}

package/dist/tools/sellers.d.ts

@@ -0,0 +1,10 @@
+import type { z } from "zod";
+import type { sellersListSchema } from "../schemas/inputs.js";
+type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare function sellersList(_args: z.infer<typeof sellersListSchema>): Promise<ToolResult>;
+export {};

package/dist/tools/sellers.js

@@ -0,0 +1,19 @@
+import { getSellers } from "../client.js";
+function text(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+export async function sellersList(_args) {
+    const { sellers } = await getSellers();
+    return text({
+        total: sellers.length,
+        sellers: sellers.map((s) => ({
+            id: s.id,
+            name: s.name,
+            role: s.role,
+            email: s.email,
+            phone: s.phone,
+            commission_percentage: s.commission_percentage,
+        })),
+        hint: "Use os IDs acima no campo sellers da tool create_sale para vincular vendedores e comissoes.",
+    });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "mcp-supabase-crm-biancode",
+  "version": "1.0.0",
+  "description": "MCP server for CRM Biancode - list sellers and create sales via Supabase Edge Functions",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-supabase-crm-biancode": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "p-retry": "^6.2.0",
+    "undici": "^6.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,114 @@
+/**
+ * HTTP client for CRM Biancode Edge Functions (list-sellers, create-sale).
+ * Auth via x-api-token header.
+ */
+
+import pRetry from "p-retry";
+import { fetch as undiciFetch } from "undici";
+
+const BASE_URL = "https://pxfjpxepjcvuiftbztar.supabase.co/functions/v1";
+const REQUEST_TIMEOUT_MS = 15_000;
+
+function getConfig() {
+  const token = process.env.SUPABASE_CRM_API_TOKEN;
+  if (!token) {
+    throw new Error("SUPABASE_CRM_API_TOKEN is required");
+  }
+  return { token };
+}
+
+function headers(token: string): Record<string, string> {
+  return {
+    "x-api-token": token,
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  };
+}
+
+async function request<T>(
+  path: string,
+  token: string,
+  options: { method?: string; body?: string } = {}
+): Promise<T> {
+  const run = async () => {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      const res = await undiciFetch(`${BASE_URL}${path}`, {
+        method: options.method ?? "GET",
+        headers: headers(token),
+        body: options.body,
+        signal: ac.signal as AbortSignal,
+      });
+      if (res.status === 429 || (res.status >= 500 && res.status < 600)) {
+        throw new Error(`HTTP ${res.status}`);
+      }
+      if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`CRM API ${res.status}: ${text.slice(0, 300)}`);
+      }
+      return res.json() as Promise<T>;
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+
+  return pRetry(run, {
+    retries: 3,
+    onFailedAttempt: (e) => {
+      if (e.retriesLeft > 0) {
+        console.error(`[supabase-crm] Retry after ${e.message}`);
+      }
+    },
+  });
+}
+
+export interface Seller {
+  id: string;
+  name: string;
+  role: string;
+  email?: string | null;
+  phone?: string | null;
+  commission_percentage?: number;
+}
+
+export interface ListSellersResponse {
+  sellers: Seller[];
+}
+
+export interface CreateSaleBody {
+  client_id: string;
+  title: string;
+  total_amount: number;
+  sale_date: string;
+  description?: string;
+  installments?: number;
+  due_day?: number;
+  installment_start_date?: string;
+  status?: string;
+  goal_id?: string;
+  tax_percentage?: number;
+  gateway_fee_percentage?: number;
+  sellers?: Array<{ seller_id: string; commission_amount: number }>;
+}
+
+export interface CreateSaleResponse {
+  success: boolean;
+  sale_id: string;
+  installments_created: number;
+  receivables_created: number;
+  sellers_linked: number;
+}
+
+export async function getSellers(): Promise<ListSellersResponse> {
+  const { token } = getConfig();
+  return request<ListSellersResponse>("/list-sellers", token);
+}
+
+export async function createSale(body: CreateSaleBody): Promise<CreateSaleResponse> {
+  const { token } = getConfig();
+  return request<CreateSaleResponse>("/create-sale", token, {
+    method: "POST",
+    body: JSON.stringify(body),
+  });
+}

package/src/index.ts

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "node:http";
+import { sellersList } from "./tools/sellers.js";
+import { createSaleTool } from "./tools/sales.js";
+import * as schemas from "./schemas/inputs.js";
+
+type ToolResult = { content: Array<{ type: "text"; text: string }> };
+
+function safe<T>(
+  name: string,
+  fn: (args: T) => Promise<ToolResult>
+): (args: T) => Promise<ToolResult> {
+  return async (args: T) => {
+    try {
+      return await fn(args);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      console.error(`[mcp-supabase-crm-biancode] ${name} failed: ${msg}`);
+      return { content: [{ type: "text" as const, text: JSON.stringify({ error: msg }) }] };
+    }
+  };
+}
+
+const server = new McpServer({
+  name: "supabase-crm-biancode",
+  version: "1.0.0",
+});
+
+server.registerTool(
+  "sellers_list",
+  {
+    title: "List sellers",
+    description:
+      "Lista vendedores cadastrados no CRM. Use para obter os IDs ao cadastrar uma venda e escolher quem participou (comissao).",
+    inputSchema: schemas.sellersListSchema,
+  },
+  safe("sellers_list", (a) => sellersList(a))
+);
+
+server.registerTool(
+  "create_sale",
+  {
+    title: "Create sale",
+    description:
+      "Cadastra nova venda no CRM. Insere em sales, sale_installments, accounts_receivable e sale_sellers. Chame sellers_list antes para obter IDs dos vendedores.",
+    inputSchema: schemas.createSaleSchema,
+  },
+  safe("create_sale", (a) => createSaleTool(a))
+);
+
+const port = parseInt(process.env.MCP_PORT ?? "", 10);
+
+if (port > 0) {
+  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+  const httpServer = createServer((req, res) => {
+    if (req.url === "/health") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ status: "ok" }));
+      return;
+    }
+    transport.handleRequest(req, res);
+  });
+  await server.connect(transport);
+  httpServer.listen(port, () => {
+    console.error(`[mcp-supabase-crm-biancode] HTTP transport listening on port ${port}`);
+  });
+} else {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}

package/src/schemas/inputs.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+
+const dateStr = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Formato YYYY-MM-DD");
+
+export const sellersListSchema = z.object({});
+
+export const sellerEntrySchema = z.object({
+  seller_id: z.string().uuid().describe("UUID do vendedor (use sellers_list para obter os IDs)"),
+  commission_amount: z.number().min(0).describe("Valor da comissao em reais (total da venda)"),
+});
+
+export const createSaleSchema = z.object({
+  client_id: z.string().uuid().describe("UUID do cliente no CRM"),
+  title: z.string().min(1).describe("Nome/titulo da venda"),
+  total_amount: z.number().positive().describe("Valor total da venda em reais"),
+  sale_date: dateStr.describe("Data da venda (YYYY-MM-DD)"),
+  description: z.string().optional().describe("Descricao opcional"),
+  installments: z.number().int().min(1).max(24).optional().default(1).describe("Numero de parcelas"),
+  due_day: z.number().int().min(1).max(28).optional().default(15).describe("Dia do vencimento de cada parcela"),
+  installment_start_date: dateStr.optional().describe("Data da primeira parcela (YYYY-MM-DD)"),
+  status: z.string().optional().default("pending").describe("Status da venda"),
+  goal_id: z.string().uuid().optional().describe("UUID da meta associada"),
+  tax_percentage: z.number().min(0).max(100).optional().default(0).describe("Percentual de imposto"),
+  gateway_fee_percentage: z.number().min(0).max(100).optional().default(0).describe("Percentual de taxa gateway"),
+  sellers: z
+    .array(sellerEntrySchema)
+    .optional()
+    .describe("Vendedores que participaram da venda e suas comissoes (use sellers_list para obter IDs)"),
+});

package/src/tools/sales.ts

@@ -0,0 +1,31 @@
+import { createSale } from "../client.js";
+import type { z } from "zod";
+import type { createSaleSchema } from "../schemas/inputs.js";
+
+type ToolResult = { content: Array<{ type: "text"; text: string }> };
+
+function text(data: unknown): ToolResult {
+  return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+export async function createSaleTool(
+  args: z.infer<typeof createSaleSchema>
+): Promise<ToolResult> {
+  const body = {
+    client_id: args.client_id,
+    title: args.title,
+    total_amount: args.total_amount,
+    sale_date: args.sale_date,
+    description: args.description,
+    installments: args.installments,
+    due_day: args.due_day,
+    installment_start_date: args.installment_start_date,
+    status: args.status,
+    goal_id: args.goal_id,
+    tax_percentage: args.tax_percentage,
+    gateway_fee_percentage: args.gateway_fee_percentage,
+    sellers: args.sellers,
+  };
+  const result = await createSale(body);
+  return text(result);
+}

package/src/tools/sellers.ts

@@ -0,0 +1,27 @@
+import { getSellers } from "../client.js";
+import type { z } from "zod";
+import type { sellersListSchema } from "../schemas/inputs.js";
+
+type ToolResult = { content: Array<{ type: "text"; text: string }> };
+
+function text(data: unknown): ToolResult {
+  return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+export async function sellersList(
+  _args: z.infer<typeof sellersListSchema>
+): Promise<ToolResult> {
+  const { sellers } = await getSellers();
+  return text({
+    total: sellers.length,
+    sellers: sellers.map((s) => ({
+      id: s.id,
+      name: s.name,
+      role: s.role,
+      email: s.email,
+      phone: s.phone,
+      commission_percentage: s.commission_percentage,
+    })),
+    hint: "Use os IDs acima no campo sellers da tool create_sale para vincular vendedores e comissoes.",
+  });
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}