mcpField
M
mcp-siigo

mcp-siigo

Local
github.com/codesparFinance275Updated 4w ago
Repository

About mcp-siigo

mcp-siigo is an MCP server for Siigo, a Colombian accounting platform with integrated DIAN electronic invoicing. It is aimed at users who want to manage invoices, customers, products and purchase documents from an MCP client. Authentication uses a Bearer access token together with an API key.

Key features

  1. 01DIAN electronic invoice creation and PDF retrieval
  2. 02Credit note creation and lookup
  3. 03Customer and product create, read, update and delete
  4. 04Purchase document creation and listing
  5. 05Warehouse, tax and payment method lookup

Use cases

  1. 01Issue DIAN electronic invoices from an MCP client
  2. 02Create credit notes against existing invoices
  3. 03Look up customers, products and warehouses

MCP support

This is an MCP server that exposes 22 tools to MCP clients for invoices, customers, products and documents in the Siigo API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "codespar-mcp-siigo": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-siigo"
      ],
      "env": {
        "SIIGO_API_KEY": "<SIIGO_API_KEY>",
        "SIIGO_ACCESS_TOKEN": "<SIIGO_ACCESS_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @codespar/mcp-siigo
Environment variables to set
SIIGO_API_KEYSecretAPI key for Siigo
SIIGO_ACCESS_TOKENSecretBearer access token

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@codespar/mcp-siigo0.2.2

Tools

22

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
datestringYesInvoice date (YYYY-MM-DD)
itemsarrayYesInvoice items
customerobjectYesCustomer reference
customer.branch_officenumberNoBranch office (default 0)
customer.identificationstringYesCustomer NIT or CC
documentobjectYesDocument type
document.idnumberYesDocument type ID
paymentsarrayYesPayment methods

Details

From the project README

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

VariableRequiredDescription
SIIGO_API_KEYYesAPI key from Siigo
SIIGO_ACCESS_TOKENYesBearer access token
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (22)

ToolPurpose
create_invoiceCreate an invoice (DIAN electronic invoice)
get_invoiceGet invoice details by ID
list_invoicesList invoices
create_credit_noteCreate a credit note against an invoice
list_customersList customers
create_customerCreate a customer
list_productsList products
create_productCreate a product
get_invoice_pdfGet the PDF document for an invoice
get_credit_noteGet a credit note by ID
list_credit_notesList credit notes
update_customerUpdate an existing customer
delete_customerDelete a customer
update_productUpdate an existing product
delete_productDelete a product
create_purchaseCreate a purchase document
list_purchasesList purchase documents
list_document_typesList document types (e.g., FV for invoice, NC for credit note, FC for purchase)
list_usersList Siigo users (sellers)
list_warehousesList warehouses (bodegas)
list_taxesList available tax types
list_payment_methodsList available payment methods

Auth

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

API Reference

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.