io.github.codespar/mcp-siigo

Official

by codespar · TypeScript

Siigo — Colombian accounting + DIAN e-invoicing

MCP Siigo (io.github.codespar/mcp-siigo)

MCP Siigo is a Model Context Protocol server for Siigo, a Colombian accounting platform with integrated DIAN electronic invoicing. It provides access to Siigo capabilities via stdio (default) or HTTP, configured through environment variables such as SIIGO_API_KEY and SIIGO_ACCESS_TOKEN.

🛠️ Key Features

MCP server for Siigo accounting + DIAN e-invoicing
Supports running via stdio or with --http (HTTP mode)
Uses required credentials: SIIGO_API_KEY and SIIGO_ACCESS_TOKEN

🚀 Use Cases

Integrate Colombian accounting workflows with DIAN electronic invoicing
Use MCP tooling to connect LLM applications with Siigo APIs

⚡ Developer Benefits

Simple startup via npx tsx .../index.ts
Clear environment variable requirements (API key + bearer token)
Optional MCP_HTTP setting noted as not required

⚠️ Limitations

Requires SIIGO_API_KEY and SIIGO_ACCESS_TOKEN; no optional credentials are listed

Topics

agentic-commerceai-agentsbrazilclaudefintechlatin-americallm-toolsmcpmodel-context-protocolnfeopen-financepaymentspix

packages/colombia/siigo/README.md3 KBView on GitHub

MCP Siigo

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

Quick Start

bash

# 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

Install

Configuration

Environment variables

SIIGO_API_KEYrequiredsecret

API key for Siigo

SIIGO_ACCESS_TOKENrequiredsecret

Bearer access token

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-siigo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-siigo@0.2.2"
      ],
      "env": {
        "SIIGO_API_KEY": "<YOUR_SIIGO_API_KEY>",
        "SIIGO_ACCESS_TOKEN": "<YOUR_SIIGO_ACCESS_TOKEN>"
      }
    }
  }
}