Siigo MCP Server

Instructions

Implementation Reference

• src/siigo-client.ts:180-182 (handler)

  Core handler function that makes the GET request to Siigo API /v1/payment-receipts/{id}
  async getPaymentReceipt(id: string): Promise<SiigoApiResponse<any>> { return this.makeRequest<any>('GET', `/v1/payment-receipts/${id}`); }
• src/index.ts:1036-1039 (handler)

  MCP server handler that invokes SiigoClient.getPaymentReceipt and formats response as JSON text
  private async handleGetPaymentReceipt(args: any) { const result = await this.siigoClient.getPaymentReceipt(args.id); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; }
• src/index.ts:589-595 (schema)

  Input schema validation requiring 'id' string parameter
  type: 'object', properties: { id: { type: 'string', description: 'Payment receipt ID' }, }, required: ['id'], }, },
• src/index.ts:129-130 (registration)

  Tool registration in the switch statement dispatching to handler
  case 'siigo_get_payment_receipt': return await this.handleGetPaymentReceipt(args);
• src/siigo-client.ts:41-59 (helper)

  Helper function that handles authentication and makes authenticated HTTP requests to Siigo API using axios
  private async makeRequest<T>(method: string, endpoint: string, data?: any, params?: any): Promise<SiigoApiResponse<T>> { await this.authenticate(); try { const response: AxiosResponse<SiigoApiResponse<T>> = await this.httpClient.request({ method, url: endpoint, data, params, }); return response.data; } catch (error: any) { if (error.response?.data) { return error.response.data; } throw new Error(`API request failed: ${error.message}`); } }