Frihet MCP Server

Instructions

Implementation Reference

• src/tools/clients.ts:96-105 (handler)

  The handler function for the 'create_client' tool that executes the tool logic - receives input, calls client.createClient(), and returns the formatted result

  async (input) => {
    try {
      const result = await client.createClient(input);
      return {
        content: [{ type: "text", text: formatRecord("Client created", result) }],
      };
    } catch (error) {
      return handleToolError(error);
    }
  },

• src/tools/clients.ts:78-95 (registration)

  Tool registration for 'create_client' including the tool name, title, description, annotations, and inputSchema with Zod validation for name, email, phone, taxId, and address fields

  server.registerTool(
    "create_client",
    {
      title: "Create Client",
      description:
        "Create a new client/customer. Requires at minimum a name. " +
        "Clients are used when creating invoices and quotes. " +
        "/ Crea un nuevo cliente. Requiere como minimo un nombre. " +
        "Los clientes se usan al crear facturas y presupuestos.",
      annotations: CREATE_ANNOTATIONS,
      inputSchema: {
        name: z.string().describe("Client/company name / Nombre del cliente o empresa"),
        email: z.string().optional().describe("Email address / Correo electronico"),
        phone: z.string().optional().describe("Phone number / Telefono"),
        taxId: z.string().optional().describe("Tax ID (NIF/CIF/VAT) / NIF o CIF"),
        address: addressSchema,
      },
    },

• src/types.ts:93-94 (schema)

  TypeScript type definition for CreateClientInput - requires 'name' and optionally allows email, phone, taxId, and address fields

  export type CreateClientInput = Pick<Client, "name"> &
    Partial<Pick<Client, "email" | "phone" | "taxId" | "address">>;

• src/client.ts:259-261 (helper)

  The FrihetClient.createClient method that makes the actual HTTP POST request to '/clients' endpoint

  async createClient(data: Record<string, unknown>): Promise<Record<string, unknown>> {
    return this.request("POST", "/clients", data);
  }

• src/client-interface.ts:30-30 (schema)

  Interface definition for createClient method in IFrihetClient - defines the contract that both local and remote client implementations must satisfy

  createClient(data: Record<string, unknown>): Promise<Record<string, unknown>>;