InvoiceExpress MCP

import type { McpTool } from '../types.js'; import type { CreateGuideRequest } from '../../api/types/guide.js'; import { z } from 'zod'; const addressSchema = z.object({ detail: z.string().describe('Address detail'), city: z.string().describe('City'), postal_code: z.string().describe('Postal code'), country: z.string().describe('Country'), }); const clientSchema = z.object({ name: z.string().describe('Client name'), code: z.string().describe('Client code'), email: z.string().optional().describe('Client email'), address: z.string().optional().describe('Client address'), city: z.string().optional().describe('Client city'), postal_code: z.string().optional().describe('Client postal code'), country: z.string().optional().describe('Client country'), fiscal_id: z.string().optional().describe('Client fiscal ID'), website: z.string().optional().describe('Client website'), phone: z.string().optional().describe('Client phone'), fax: z.string().optional().describe('Client fax'), observations: z.string().optional().describe('Client observations'), }); const itemSchema = z.object({ name: z.string().describe('Item name'), description: z.string().optional().describe('Item description'), unit_price: z.number().describe('Unit price'), quantity: z.number().describe('Quantity'), unit: z.string().optional().describe('Unit of measurement'), discount: z.number().optional().describe('Discount percentage'), tax: z.object({ name: z.string().describe('Tax name'), value: z.number().describe('Tax value'), }).optional().describe('Tax information'), }); const paramsSchema = z.object({ type: z.enum(['shipping', 'transport', 'devolution']).default('shipping') .describe('The type of guide to create'), date: z.string().describe('Guide date (YYYY-MM-DD)'), due_date: z.string().describe('Due date (YYYY-MM-DD)'), loaded_at: z.string().describe('Loaded date and time (YYYY-MM-DD HH:MM or ISO 8601)'), address_from: addressSchema.describe('Origin address'), address_to: addressSchema.describe('Destination address'), client: clientSchema.describe('Client information'), items: z.array(itemSchema).describe('List of items'), license_plate: z.string().optional().describe('License plate for transport'), reference: z.string().optional().describe('Reference number'), observations: z.string().optional().describe('Observations'), retention: z.string().optional().describe('Retention value'), tax_exemption: z.string().optional().describe('Tax exemption reason'), sequence_id: z.string().optional().describe('Sequence ID'), manual_sequence_number: z.string().optional().describe('Manual sequence number'), }); export const createGuideTool: McpTool = { name: 'guide_create', description: 'Create a new guide (shipping, transport, or devolution)', inputSchema: { type: 'object', required: ['date', 'due_date', 'loaded_at', 'address_from', 'address_to', 'client', 'items'], properties: { type: { type: 'string', enum: ['shipping', 'transport', 'devolution'], default: 'shipping', description: 'The type of guide to create' }, date: { type: 'string', description: 'Guide date (YYYY-MM-DD)' }, due_date: { type: 'string', description: 'Due date (YYYY-MM-DD)' }, loaded_at: { type: 'string', description: 'Loaded date and time (YYYY-MM-DD HH:MM or ISO 8601)' }, address_from: { type: 'object', required: ['detail', 'city', 'postal_code', 'country'], properties: { detail: { type: 'string', description: 'Address detail' }, city: { type: 'string', description: 'City' }, postal_code: { type: 'string', description: 'Postal code' }, country: { type: 'string', description: 'Country' }, }, }, address_to: { type: 'object', required: ['detail', 'city', 'postal_code', 'country'], properties: { detail: { type: 'string', description: 'Address detail' }, city: { type: 'string', description: 'City' }, postal_code: { type: 'string', description: 'Postal code' }, country: { type: 'string', description: 'Country' }, }, }, client: { type: 'object', required: ['name', 'code'], properties: { name: { type: 'string', description: 'Client name' }, code: { type: 'string', description: 'Client code' }, email: { type: 'string', description: 'Client email' }, address: { type: 'string', description: 'Client address' }, city: { type: 'string', description: 'Client city' }, postal_code: { type: 'string', description: 'Client postal code' }, country: { type: 'string', description: 'Client country' }, fiscal_id: { type: 'string', description: 'Client fiscal ID' }, website: { type: 'string', description: 'Client website' }, phone: { type: 'string', description: 'Client phone' }, fax: { type: 'string', description: 'Client fax' }, observations: { type: 'string', description: 'Client observations' }, }, }, items: { type: 'array', items: { type: 'object', required: ['name', 'unit_price', 'quantity'], properties: { name: { type: 'string', description: 'Item name' }, description: { type: 'string', description: 'Item description' }, unit_price: { type: 'number', description: 'Unit price' }, quantity: { type: 'number', description: 'Quantity' }, unit: { type: 'string', description: 'Unit of measurement' }, discount: { type: 'number', description: 'Discount percentage' }, tax: { type: 'object', properties: { name: { type: 'string', description: 'Tax name' }, value: { type: 'number', description: 'Tax value' }, }, }, }, }, }, license_plate: { type: 'string', description: 'License plate for transport' }, reference: { type: 'string', description: 'Reference number' }, observations: { type: 'string', description: 'Observations' }, retention: { type: 'string', description: 'Retention value' }, tax_exemption: { type: 'string', description: 'Tax exemption reason' }, sequence_id: { type: 'string', description: 'Sequence ID' }, manual_sequence_number: { type: 'string', description: 'Manual sequence number' }, }, }, handler: async (args, server) => { const params = paramsSchema.parse(args); const guideData: CreateGuideRequest = { [params.type]: { date: params.date, due_date: params.due_date, loaded_at: params.loaded_at, address_from: params.address_from, address_to: params.address_to, client: params.client, items: params.items, license_plate: params.license_plate, reference: params.reference, observations: params.observations, retention: params.retention, tax_exemption: params.tax_exemption, sequence_id: params.sequence_id, manual_sequence_number: params.manual_sequence_number, }, }; const result = await server.guidesEndpoint.create(guideData); return result; }, };