siigo-mcp-server 2.1.0 → 3.0.1

package/CHANGELOG.md

@@ -5,6 +5,98 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.1] - 2026-03-11
+
+### Fixed
+- API failures now surface as proper MCP tool errors instead of success payloads, preserving Siigo error details for callers.
+- Webhook updates now target the specific webhook resource by ID.
+- Product and customer partial-match search now scans all result pages before filtering, avoiding missed matches beyond the first page.
+
+### Changed
+- Switched project package management to pnpm and added `pnpm-lock.yaml` plus `packageManager` metadata.
+- Updated direct dependencies to the latest safe patch/minor releases used by this project.
+- Added Jest smoke coverage for API error propagation, webhook updates, and paginated search behavior.
+
+## [3.0.0] - 2026-02-13
+
+### BREAKING CHANGES
+- **MCP SDK upgraded from v0.6 to v1.26** - Uses the new `McpServer` high-level API with `registerTool()` and Zod input schemas. The low-level `Server` class with `ListToolsRequestSchema`/`CallToolRequestSchema` handlers has been replaced.
+- **Package is now ESM** - Added `"type": "module"` to package.json, switched tsconfig to `module: "Node16"`.
+- **`zod` is now a required dependency** (peer dependency of the new MCP SDK).
+- **Report endpoints fixed** - Trial balance reports now use `POST` method and correct API paths (`/v1/test-balance-report`, `/v1/test-balance-report-by-thirdparty`) as per the Siigo API spec. Previously used `GET` with incorrect paths.
+- **Bin entry point changed** - `siigo-mcp` bin now points directly to `dist/index.js` instead of a wrapper script.
+
+### Added - New Endpoints (17 new tools, total 68 tools)
+
+#### Quotations (Cotizaciones) - 5 tools
+- `siigo_get_quotations` - List quotations with date filters
+- `siigo_get_quotation` - Get a specific quotation by ID
+- `siigo_create_quotation` - Create a new quotation (document type C)
+- `siigo_update_quotation` - Update an existing quotation
+- `siigo_delete_quotation` - Delete a quotation
+
+#### Inventory Categories (Categorias de Inventario) - 2 tools
+- `siigo_create_account_group` - Create a new inventory category
+- `siigo_update_account_group` - Update an existing inventory category
+
+#### Invoice Enhancements - 4 tools
+- `siigo_create_invoice_batch` - Create invoices in batch asynchronously with webhook notification
+- `siigo_annul_invoice` - Annul (void) a sales invoice
+- `siigo_get_invoice_xml` - Get invoice electronic XML as base64
+- `siigo_get_invoice_stamp_errors` - Get DIAN rejection errors for failed electronic invoices
+
+#### Credit Note Enhancements - 1 tool
+- `siigo_get_credit_note_pdf` - Get credit note PDF as base64
+
+#### Catalog Enhancements - 1 tool
+- `siigo_get_fixed_assets` - Get fixed assets catalog
+
+#### Webhooks - 4 tools
+- `siigo_get_webhooks` - List webhook subscriptions
+- `siigo_create_webhook` - Subscribe to a webhook event
+- `siigo_update_webhook` - Update a webhook subscription
+- `siigo_delete_webhook` - Delete a webhook subscription
+
+### Enhanced - Existing Endpoints
+
+#### Combo Products
+- `siigo_create_product` and `siigo_update_product` now support `type: "Combo"` with a `components` array containing `code` and `quantity` for each component product.
+
+#### Healthcare Sector (Sector Salud)
+- `siigo_create_invoice` and `siigo_create_credit_note` now support `healthcare_company` object with fields: `operation_type` (SS-CUFE, SS-SinAporte, SS-Recaudo), `period_start`, `period_end`, `payment_method`, `service_plan`, `policy_number`, `contract_number`, `copayment`, `coinsurance`, `cost_sharing`, `recovery_charge`.
+
+#### Document Type Filter
+- `siigo_get_document_types` now supports `RP` (payment receipt) and `C` (quotation) type codes in addition to FV, RC, NC, FC, CC.
+
+#### Credit Notes
+- `siigo_create_credit_note` now supports `invoice_data` for referencing external invoices not in Siigo, and `reason` field.
+
+### Changed - Architecture & Code Quality
+
+#### MCP SDK Upgrade (0.6 -> 1.26)
+- Migrated from low-level `Server` with manual request handlers to high-level `McpServer` with `registerTool()` pattern
+- All tool input schemas now use Zod for runtime validation
+- Added tool annotations (`readOnlyHint`, `destructiveHint`) for all 59 tools
+- Server version now correctly reports `3.0.0`
+
+#### Full TypeScript Type Safety
+- Added proper interfaces for all document types: `SiigoQuotation`, `SiigoVoucher`, `SiigoPaymentReceipt`, `SiigoCreditNote`, `SiigoPurchase`, `SiigoJournal`, `SiigoWebhook`, `SiigoBatchInvoiceRequest`, `SiigoAccountGroupIn`, `SiigoFixedAsset`, and more
+- Replaced all `any` types in `siigo-client.ts` with proper typed interfaces
+- Added comprehensive types for catalogs, reports, and shared structures
+
+#### Bug Fixes
+- Fixed server version reporting `1.0.0` instead of actual version
+- Fixed trial balance report endpoints using wrong HTTP method (`GET` -> `POST`)
+- Fixed trial balance report endpoint paths to match Siigo API spec
+- Added 120s timeout to HTTP client as recommended by Siigo API docs
+
+### Migration Guide
+If upgrading from v2.x.x:
+1. Run `npm install` to get the new SDK and zod dependencies
+2. If importing types, note that many `any` types have been replaced with proper interfaces
+3. The bin entry point has changed - if you reference it directly, update paths accordingly
+4. Report tools may behave differently as they now use the correct HTTP method (POST)
+
 ## [2.1.0] - 2024-09-17
 
 ### Added
@@ -61,4 +153,4 @@ If upgrading from v1.x.x, you need to:
 - Comprehensive TypeScript implementation
 - Environment variable configuration
 - Automatic token management and refresh
-- Error handling and validation
+- Error handling and validation

package/README.md

@@ -1,248 +1,340 @@
 # Siigo MCP Server
 
-A Model Context Protocol (MCP) server that provides integration with the Siigo API, enabling access to Colombian accounting software features including products, customers, invoices, purchases, credit notes, vouchers, payment receipts, and journals.
+A Model Context Protocol (MCP) server that provides full integration with the Siigo API, enabling access to Colombian accounting software features including products, customers, invoices, quotations, purchases, credit notes, vouchers, payment receipts, journals, webhooks, and more.
+
+**v3.0.1** - Full Siigo API parity with 68 tools, MCP SDK v1.27, Zod schemas, improved MCP error propagation, and complete TypeScript type safety.
 
 ## Features
 
-This MCP server provides access to all major Siigo API endpoints:
+This MCP server provides access to all Siigo API endpoints:
 
 ### Core Resources
-- **Products**: Create, read, update, and delete products/services
-- **Customers**: Manage customer/supplier information
-- **Invoices**: Handle sales invoices with electronic invoicing support
-- **Purchases**: Manage purchase invoices and expenses
-- **Credit Notes**: Create and manage credit notes
-- **Vouchers**: Handle cash receipts (recibos de caja)
-- **Payment Receipts**: Manage payment receipts/disbursements
-- **Journals**: Handle accounting journal entries
+- **Products**: Full CRUD for products, services, consumer goods, and **Combo** products with components
+- **Customers**: Manage customers, suppliers, and third parties
+- **Invoices**: Sales invoices with electronic invoicing, **healthcare sector**, **batch creation**, annulment, PDF, XML, and DIAN error queries
+- **Quotations**: Full CRUD for quotations (cotizaciones) -- **NEW in v3**
+- **Purchases**: Purchase invoices and expenses (including Documentos de Soporte via `document_support` flag)
+- **Credit Notes**: Create and query credit notes with PDF support and healthcare sector fields
+- **Vouchers**: Cash receipts (recibos de caja) - create and query
+- **Payment Receipts**: Payment receipts / disbursements (recibos de pago / comprobantes de egreso) - full CRUD
+- **Journals**: Accounting journal entries (comprobantes contables)
+- **Webhooks**: Subscribe to and manage webhook events -- **NEW in v3**
+
+### Inventory Management
+- **Account Groups**: Create and edit inventory categories -- **NEW in v3**
 
 ### Catalogs
-- Document types, taxes, payment types
-- Cost centers, users, warehouses
-- Price lists, account groups, cities
-- ID types, fiscal responsibilities
+- Document types (FV, RC, NC, FC, CC, RP, C)
+- Taxes, payment types, cost centers
+- Users/sellers, warehouses, price lists
+- Account groups, cities, ID types
+- Fiscal responsibilities, **fixed assets**
 
 ### Reports
-- Trial balance reports
-- Trial balance by third party
+- Trial balance reports (general and by third party)
 - Accounts payable reports
 
 ## Installation
 
 ### Option 1: NPX (Recommended - No Installation Required)
 ```bash
-# Run directly with npx - downloads and runs the latest version
 npx siigo-mcp-server
 ```
 
 ### Option 2: Global Installation
 ```bash
-# Install globally
 npm install -g siigo-mcp-server
-
-# Then run
 siigo-mcp
 ```
 
-### Option 3: Local Development/Building from Source
-1. Clone this repository:
-```bash
-git clone https://github.com/jdlar/siigo-mcp-server.git
-cd siigo-mcp-server
-```
-
-2. Install dependencies:
+### Option 3: Local Development / Building from Source
 ```bash
+git clone https://github.com/jdlar1/siigo-mcp.git
+cd siigo-mcp
 npm install
-```
-
-3. Build the TypeScript code:
-```bash
 npm run build
-```
-
-4. Set up environment variables by copying the example file:
-```bash
 cp .env.example .env
-```
-
-5. Edit `.env` with your Siigo credentials:
-```bash
-SIIGO_USERNAME=your_siigo_username
-SIIGO_ACCESS_KEY=your_siigo_access_key
-SIIGO_PARTNER_ID=your_app_name
-SIIGO_BASE_URL=https://api.siigo.com
+# Edit .env with your Siigo credentials
 ```
 
 ## Configuration
 
 ### Required Environment Variables
 
-- `SIIGO_USERNAME`: Your Siigo API username
-- `SIIGO_ACCESS_KEY`: Your Siigo API access key  
-- `SIIGO_PARTNER_ID`: Partner ID for API identification (3-100 alphanumeric characters, no spaces or special characters)
+| Variable | Description |
+|---|---|
+| `SIIGO_USERNAME` | Your Siigo API username |
+| `SIIGO_ACCESS_KEY` | Your Siigo API access key |
+| `SIIGO_PARTNER_ID` | Partner ID for API identification (3-100 alphanumeric chars, no spaces) |
 
 ### Optional Environment Variables
 
-- `SIIGO_BASE_URL`: API base URL (defaults to `https://api.siigo.com`)
+| Variable | Default | Description |
+|---|---|---|
+| `SIIGO_BASE_URL` | `https://api.siigo.com` | API base URL |
 
 ### Getting Siigo API Credentials
 
 1. Sign up for a Siigo account at [siigo.com](https://siigo.com)
 2. Access the API section in your Siigo dashboard
 3. Generate your API credentials (username and access key)
-4. For testing, you can use the sandbox environment
-
-## Usage
+4. For testing, use the sandbox environment
 
-### Running the Server
+## MCP Client Configuration
 
-#### Using NPX (Recommended)
-```bash
-# Set environment variables and run
-SIIGO_USERNAME=your_username SIIGO_ACCESS_KEY=your_key SIIGO_PARTNER_ID=your_app npx siigo-mcp-server
-```
+### Claude Desktop
 
-#### Using Global Installation
-```bash
-# Set environment variables and run
-SIIGO_USERNAME=your_username SIIGO_ACCESS_KEY=your_key SIIGO_PARTNER_ID=your_app siigo-mcp
-```
+Add to your Claude Desktop config (`claude_desktop_config.json`):
 
-#### For Development (from source)
-```bash
-# Start the server
-npm start
-
-# Or for development with auto-reload
-npm run dev
-```
-
-### Available Tools
-
-The server provides 40+ tools for interacting with the Siigo API. Here are some examples:
-
-#### Products
-- `siigo_get_products` - List all products
-- `siigo_get_product` - Get a specific product by ID
-- `siigo_create_product` - Create a new product
-- `siigo_update_product` - Update an existing product
-- `siigo_delete_product` - Delete a product
-- `siigo_search_products` - **NEW!** Search products by code, name, or reference
-
-#### Customers
-- `siigo_get_customers` - List all customers
-- `siigo_get_customer` - Get a specific customer by ID
-- `siigo_create_customer` - Create a new customer
-- `siigo_update_customer` - Update an existing customer
-- `siigo_search_customers` - **NEW!** Search customers by identification, name, or type
-
-#### Invoices
-- `siigo_get_invoices` - List all invoices
-- `siigo_get_invoice` - Get a specific invoice by ID
-- `siigo_create_invoice` - Create a new invoice
-- `siigo_update_invoice` - Update an existing invoice
-- `siigo_delete_invoice` - Delete an invoice
-- `siigo_get_invoice_pdf` - Get invoice PDF
-- `siigo_send_invoice_email` - Send invoice by email
-
-#### Catalogs
-- `siigo_get_document_types` - Get document types
-- `siigo_get_taxes` - Get tax information
-- `siigo_get_payment_types` - Get payment methods
-- `siigo_get_cost_centers` - Get cost centers
-- `siigo_get_users` - Get system users
-
-#### Reports
-- `siigo_get_trial_balance` - Generate trial balance report
-- `siigo_get_accounts_payable` - Get accounts payable report
-
-### Example Usage
-
-#### Search for Customers
 ```json
 {
-  "name": "siigo_search_customers",
-  "arguments": {
-    "identification": "12345",
-    "type": "Customer",
-    "page_size": 10
+  "mcpServers": {
+    "siigo": {
+      "command": "npx",
+      "args": ["siigo-mcp-server"],
+      "env": {
+        "SIIGO_USERNAME": "your_username",
+        "SIIGO_ACCESS_KEY": "your_access_key",
+        "SIIGO_PARTNER_ID": "your_app_name"
+      }
+    }
   }
 }
 ```
 
-#### Search for Products
+## Available Tools (68 total)
+
+### Products (6 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_products` | List products with pagination | read-only |
+| `siigo_get_product` | Get a product by ID | read-only |
+| `siigo_create_product` | Create product (supports **Combo** type with components) | |
+| `siigo_update_product` | Update a product | |
+| `siigo_delete_product` | Delete a product | destructive |
+| `siigo_search_products` | Search by code, name, or reference (partial match) | read-only |
+
+### Account Groups / Inventory Categories (3 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_account_groups` | List inventory categories | read-only |
+| `siigo_create_account_group` | Create inventory category | |
+| `siigo_update_account_group` | Update inventory category | |
+
+### Customers (5 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_customers` | List customers | read-only |
+| `siigo_get_customer` | Get a customer by ID | read-only |
+| `siigo_create_customer` | Create a customer/third party | |
+| `siigo_update_customer` | Update a customer | |
+| `siigo_search_customers` | Search by identification, name, or type | read-only |
+
+### Invoices (10 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_invoices` | List invoices with date filters | read-only |
+| `siigo_get_invoice` | Get an invoice by ID | read-only |
+| `siigo_create_invoice` | Create invoice (supports **healthcare** and **transport** sectors) | |
+| `siigo_update_invoice` | Update an invoice | |
+| `siigo_delete_invoice` | Delete an invoice | destructive |
+| `siigo_annul_invoice` | Annul (void) an invoice | destructive |
+| `siigo_get_invoice_pdf` | Get invoice PDF (base64) | read-only |
+| `siigo_get_invoice_xml` | Get invoice electronic XML (base64) | read-only |
+| `siigo_get_invoice_stamp_errors` | Get DIAN rejection errors | read-only |
+| `siigo_send_invoice_email` | Send invoice by email (up to 5 addresses) | |
+
+### Batch Invoices (1 tool)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_create_invoice_batch` | Create invoices in batch (async with webhook notification) | |
+
+### Quotations (5 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_quotations` | List quotations with date filters | read-only |
+| `siigo_get_quotation` | Get a quotation by ID | read-only |
+| `siigo_create_quotation` | Create a quotation (document type C) | |
+| `siigo_update_quotation` | Update a quotation | |
+| `siigo_delete_quotation` | Delete a quotation | destructive |
+
+### Credit Notes (4 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_credit_notes` | List credit notes | read-only |
+| `siigo_get_credit_note` | Get a credit note by ID | read-only |
+| `siigo_create_credit_note` | Create credit note (supports **healthcare** sector, external invoice refs) | |
+| `siigo_get_credit_note_pdf` | Get credit note PDF (base64) | read-only |
+
+### Vouchers / Cash Receipts (3 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_vouchers` | List cash receipts (recibos de caja) | read-only |
+| `siigo_get_voucher` | Get a cash receipt by ID | read-only |
+| `siigo_create_voucher` | Create cash receipt (DebtPayment, AdvancePayment, Advanced) | |
+
+### Purchases (5 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_purchases` | List purchase invoices | read-only |
+| `siigo_get_purchase` | Get a purchase by ID | read-only |
+| `siigo_create_purchase` | Create purchase (use FC type with `document_support` for Documento Soporte) | |
+| `siigo_update_purchase` | Update a purchase | |
+| `siigo_delete_purchase` | Delete a purchase | destructive |
+
+### Payment Receipts / Disbursements (5 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_payment_receipts` | List payment receipts (recibos de pago / comprobantes de egreso) | read-only |
+| `siigo_get_payment_receipt` | Get a payment receipt by ID | read-only |
+| `siigo_create_payment_receipt` | Create payment receipt (DebtPayment, AdvancePayment, Advanced) | |
+| `siigo_update_payment_receipt` | Update a payment receipt | |
+| `siigo_delete_payment_receipt` | Delete a payment receipt | destructive |
+
+### Journals / Accounting Entries (3 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_journals` | List accounting journals (comprobantes contables) | read-only |
+| `siigo_get_journal` | Get a journal by ID | read-only |
+| `siigo_create_journal` | Create journal entry (debits must equal credits) | |
+
+### Webhooks (4 tools)
+| Tool | Description | Annotations |
+|---|---|---|
+| `siigo_get_webhooks` | List webhook subscriptions | read-only |
+| `siigo_create_webhook` | Subscribe to a webhook event | |
+| `siigo_update_webhook` | Update a webhook subscription | |
+| `siigo_delete_webhook` | Delete a webhook subscription | destructive |
+
+### Catalogs (11 tools + account groups above)
+| Tool | Description |
+|---|---|
+| `siigo_get_document_types` | Document types (FV, RC, NC, FC, CC, RP, C) |
+| `siigo_get_taxes` | Taxes (IVA, Retefuente, ReteIVA, ReteICA, etc.) |
+| `siigo_get_payment_types` | Payment methods |
+| `siigo_get_cost_centers` | Cost centers |
+| `siigo_get_users` | Users/sellers |
+| `siigo_get_warehouses` | Warehouses |
+| `siigo_get_price_lists` | Price lists (up to 12) |
+| `siigo_get_cities` | Colombian cities |
+| `siigo_get_id_types` | Identification types |
+| `siigo_get_fiscal_responsibilities` | Fiscal responsibilities |
+| `siigo_get_fixed_assets` | Fixed assets |
+
+### Reports (3 tools)
+| Tool | Description |
+|---|---|
+| `siigo_get_trial_balance` | Trial balance report (Excel) |
+| `siigo_get_trial_balance_by_third` | Trial balance by third party (Excel) |
+| `siigo_get_accounts_payable` | Accounts payable report |
+
+## Document Types Reference
+
+| Code | Spanish Name | English Name | MCP Support |
+|---|---|---|---|
+| `FV` | Factura de Venta | Sales Invoice | Full CRUD + PDF/XML/Email/Batch/Annul |
+| `RC` | Recibo de Caja | Cash Receipt | Create + Query |
+| `NC` | Nota Credito | Credit Note | Create + Query + PDF |
+| `FC` | Factura de Compra | Purchase Invoice | Full CRUD |
+| `CC` | Comprobante Contable | Accounting Journal | Create + Query |
+| `RP` | Recibo de Pago/Egreso | Payment Receipt | Full CRUD |
+| `C` | Cotizacion | Quotation | Full CRUD |
+
+## Example Usage
+
+### Create a Quotation
 ```json
 {
-  "name": "siigo_search_products",
+  "name": "siigo_create_quotation",
   "arguments": {
-    "name": "laptop",
-    "page_size": 20
+    "quotation": {
+      "document": { "id": 12345 },
+      "date": "2026-02-13",
+      "customer": { "identification": "13832081", "branch_office": 0 },
+      "seller": 629,
+      "items": [{
+        "code": "PROD001",
+        "quantity": 5,
+        "price": 50000,
+        "taxes": [{ "id": 13156 }]
+      }]
+    }
   }
 }
 ```
 
-#### Creating a Product
+### Create a Combo Product
 ```json
 {
   "name": "siigo_create_product",
   "arguments": {
     "product": {
-      "code": "PROD001",
-      "name": "Test Product",
+      "code": "COMBO-001",
+      "name": "Kit de oficina",
       "account_group": 1253,
-      "type": "Product",
-      "active": true,
-      "description": "A test product"
+      "type": "Combo",
+      "components": [
+        { "code": "PROD-001", "quantity": 2 },
+        { "code": "PROD-002", "quantity": 1 }
+      ]
     }
   }
 }
 ```
 
-#### Creating a Customer
+### Create a Healthcare Invoice
 ```json
 {
-  "name": "siigo_create_customer",
+  "name": "siigo_create_invoice",
   "arguments": {
-    "customer": {
-      "person_type": "Person",
-      "id_type": "13",
-      "identification": "12345678",
-      "name": ["John", "Doe"],
-      "address": {
-        "address": "123 Main St",
-        "city": {
-          "country_code": "Co",
-          "state_code": "11",
-          "city_code": "11001"
-        }
-      },
-      "phones": [{"number": "1234567890"}],
-      "contacts": [{
-        "first_name": "John",
-        "last_name": "Doe",
-        "email": "john@example.com"
-      }]
+    "invoice": {
+      "document": { "id": 24446 },
+      "date": "2026-02-13",
+      "customer": { "identification": "13832081" },
+      "seller": 629,
+      "items": [{ "code": "SRV001", "quantity": 1, "price": 150000 }],
+      "payments": [{ "id": 5636, "value": 150000 }],
+      "healthcare_company": {
+        "operation_type": "SS-CUFE",
+        "period_start": "2026-01-01",
+        "period_end": "2026-01-31"
+      }
     }
   }
 }
 ```
 
+### Create Batch Invoices
+```json
+{
+  "name": "siigo_create_invoice_batch",
+  "arguments": {
+    "notification_url": "https://myapp.com/webhooks/siigo-batch",
+    "invoices": [
+      {
+        "idempotency_key": "INV202602001",
+        "document": { "id": 24446 },
+        "date": "2026-02-13",
+        "customer": { "identification": "13832081" },
+        "seller": 629,
+        "items": [{ "code": "PROD001", "quantity": 1, "price": 50000 }],
+        "payments": [{ "id": 5636, "value": 50000 }]
+      }
+    ]
+  }
+}
+```
+
 ## API Rate Limits
 
-Siigo API has the following rate limits:
-- Production: 100 requests per minute per company
-- Sandbox: 10 requests per minute
+- **Production**: 100 requests per minute per company
+- **Sandbox**: 10 requests per minute
 
-## Error Handling
+The server uses a 120-second HTTP timeout as recommended by Siigo for long-running operations.
 
-The server handles various Siigo API errors and returns structured error responses. Common error scenarios include:
+## Error Handling
 
-- Authentication failures
-- Invalid parameters
-- Rate limit exceeded
-- Resource not found
-- Validation errors
+The server handles Siigo API errors and returns structured error responses with error codes, messages, and details. See the [Siigo API docs](https://siigoapi.docs.apiary.io/#introduction/codigos-de-error) for a full list of error codes.
 
 ## Development
 
@@ -251,12 +343,13 @@ The server handles various Siigo API errors and returns structured error respons
 ```
 siigo-mcp/
 ├── src/
-│   ├── index.ts          # Main MCP server implementation
-│   ├── siigo-client.ts   # Siigo API client
-│   └── types.ts          # TypeScript type definitions
+│   ├── index.ts          # MCP server - tool registration with Zod schemas
+│   ├── siigo-client.ts   # HTTP client for all Siigo API endpoints
+│   └── types.ts          # Full TypeScript interfaces for all document types
+├── dist/                 # Compiled output (ESM)
 ├── package.json
 ├── tsconfig.json
-├── .env.example
+├── CHANGELOG.md
 └── README.md
 ```
 
@@ -266,10 +359,10 @@ siigo-mcp/
 npm run build
 ```
 
-### Testing
+### Running for Development
 
 ```bash
-npm test
+npm run dev
 ```
 
 ## Contributing
@@ -277,7 +370,7 @@ npm test
 1. Fork the repository
 2. Create a feature branch
 3. Make your changes
-4. Add tests if applicable
+4. Run `npm run build` to verify
 5. Submit a pull request
 
 ## License
@@ -286,12 +379,12 @@ MIT License
 
 ## Support
 
-For issues related to:
-- Siigo API: Contact Siigo support at soporteapi@siigo.com
-- This MCP server: Create an issue in this repository
+- **Siigo API**: Contact soporteapi@siigo.com
+- **This MCP server**: [Create an issue](https://github.com/jdlar1/siigo-mcp/issues)
 
 ## Links
 
 - [Siigo API Documentation](https://siigoapi.docs.apiary.io/)
 - [Model Context Protocol](https://modelcontextprotocol.io/)
-- [Siigo Official Website](https://siigo.com/)
+- [MCP TypeScript SDK](https://www.npmjs.com/package/@modelcontextprotocol/sdk)
+- [Siigo Official Website](https://siigo.com/)