mcp-colppy

MCP Colppy

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.

MCP server for Colppy — Argentine cloud accounting platform with integrated AFIP electronic invoicing.

Quick Start

# Set your credentials
export COLPPY_API_KEY="your-api-key"
export COLPPY_COMPANY_ID="your-company-id"

# Run via stdio
npx tsx packages/argentina/colppy/src/index.ts

# Run via HTTP
npx tsx packages/argentina/colppy/src/index.ts --http

Environment Variables

Variable	Required	Description
COLPPY_API_KEY	Yes	API key from Colppy
COLPPY_COMPANY_ID	Yes	Company identifier
MCP_HTTP	No	Set to "true" to enable HTTP transport
MCP_PORT	No	HTTP port (default: 3000)

Tools (22)

Tool	Purpose
list_customers	List customers
create_customer	Create a customer
list_products	List products and services
create_invoice	Create an invoice (integrates with AFIP for electronic invoicing)
list_invoices	List invoices
get_balance	Get account balance summary
list_accounts	List chart of accounts (plan de cuentas)
create_payment	Record a payment against an invoice
update_customer	Update an existing customer's data
delete_customer	Delete a customer
get_customer_balance	Get the current account balance (cuenta corriente) for a customer
list_suppliers	List suppliers (proveedores)
create_supplier	Create a supplier (proveedor)
cancel_invoice	Cancel/void an invoice (anular comprobante)
get_invoice_pdf	Get the PDF representation of an invoice (returns URL or base64)
create_receipt	Create a receipt (recibo) — record cash/transfer received against one or more invoices
list_receipts	List receipts (recibos)
get_stock	Get current stock for a product across warehouses
list_warehouses	List warehouses (depósitos)
list_companies	List companies (empresas) accessible to the current API user
sales_report	Sales report by date range
expenses_report	Expenses/purchases report by date range

Auth

Uses API key + session authentication. The API key is sent with each request along with the company ID. Colppy uses a JSON-RPC style API where service and operation are specified in the request body.

API Reference

• Colppy API Documentation

---

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:

• COLPPY_API_KEY (required, secret) — API key for Colppy
• COLPPY_COMPANY_ID (required) — Company identifier

Issue credentials at the provider's developer portal: https://api.colppy.com/.

License

MIT