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
export COLPPY_API_KEY="your-api-key"
export COLPPY_COMPANY_ID="your-company-id"
npx tsx packages/argentina/colppy/src/index.ts
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) |
| 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
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 ColppyCOLPPY_COMPANY_ID (required) — Company identifier
Issue credentials at the provider's developer portal: https://api.colppy.com/.
License
MIT