@codespar/mcp-siigo

MCP Siigo

MCP server for Siigo — Colombian accounting platform with integrated DIAN electronic invoicing.

Quick Start

# Set your credentials
export SIIGO_API_KEY="your-api-key"
export SIIGO_ACCESS_TOKEN="your-access-token"

# Run via stdio
npx tsx packages/colombia/siigo/src/index.ts

# Run via HTTP
npx tsx packages/colombia/siigo/src/index.ts --http

Environment Variables

Variable	Required	Description
SIIGO_API_KEY	Yes	API key from Siigo
SIIGO_ACCESS_TOKEN	Yes	Bearer access token
MCP_HTTP	No	Set to "true" to enable HTTP transport
MCP_PORT	No	HTTP port (default: 3000)

Tools (22)

Tool	Purpose
create_invoice	Create an invoice (DIAN electronic invoice)
get_invoice	Get invoice details by ID
list_invoices	List invoices
create_credit_note	Create a credit note against an invoice
list_customers	List customers
create_customer	Create a customer
list_products	List products
create_product	Create a product
get_invoice_pdf	Get the PDF document for an invoice
get_credit_note	Get a credit note by ID
list_credit_notes	List credit notes
update_customer	Update an existing customer
delete_customer	Delete a customer
update_product	Update an existing product
delete_product	Delete a product
create_purchase	Create a purchase document
list_purchases	List purchase documents
list_document_types	List document types (e.g., FV for invoice, NC for credit note, FC for purchase)
list_users	List Siigo users (sellers)
list_warehouses	List warehouses (bodegas)
list_taxes	List available tax types
list_payment_methods	List available payment methods

Auth

Uses Bearer token authentication. Obtain your access token from the Siigo developer portal.

API Reference

• Siigo API Docs

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

• SIIGO_API_KEY (required, secret) — API key for Siigo
• SIIGO_ACCESS_TOKEN (required, secret) — Bearer access token

Issue credentials at the provider's developer portal: https://siigoapi.docs.apiary.io.

License

MIT