Mcp Colppy

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 24, 2026

Colppy — Argentine cloud accounting + AFIP invoicing

VerifiedSTDIODesktop onlyFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Colppy, an Argentine cloud accounting platform, letting an assistant manage customers, invoices, payments and reports.

What you can do
List, create, update and delete customers, and list suppliers and companies accessible to the API user, plus create suppliers and read a customer's current-account balance. Create, list, cancel and fetch PDFs of invoices, including AFIP electronic invoicing. Record payments and receipts against invoices, and list receipts. List products, chart of accounts, warehouses and current stock. Pull sales and expenses reports by date range and get an account balance summary.
When to use it
Useful when an assistant should work with Argentine bookkeeping in Colppy: drafting or issuing invoices, recording payments and receipts, maintaining customer and supplier records, checking stock, or producing sales and expense reports for a period.
Requirements
Runs as a local process over stdio, installed from the npm package (alpha dist-tag). Requires a Colppy API key in COLPPY_API_KEY and a company identifier in COLPPY_COMPANY_ID. Optional MCP_HTTP and MCP_PORT enable an HTTP transport. Network access to the Colppy API is needed.
Before you install
The README labels this an alpha release whose endpoint paths have not been fully live-validated; pin exact versions. The API key is a secret sent with each request. Many tools write to the accounting system, including creating invoices, payments and receipts, updating or deleting customers, and cancelling invoices, which can have legal and tax consequences under AFIP invoicing.

Installation

In SourceWeft

  1. Open Mcp Colppy in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
# Set your credentialsexport COLPPY_API_KEY="your-api-key"export COLPPY_COMPANY_ID="your-company-id"
# Run via stdionpx tsx packages/argentina/colppy/src/index.ts
# Run via HTTPnpx tsx packages/argentina/colppy/src/index.ts --http

Environment Variables

VariableRequiredDescription
COLPPY_API_KEYYesAPI key from Colppy
COLPPY_COMPANY_IDYesCompany identifier
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (22)

ToolPurpose
list_customersList customers
create_customerCreate a customer
list_productsList products and services
create_invoiceCreate an invoice (integrates with AFIP for electronic invoicing)
list_invoicesList invoices
get_balanceGet account balance summary
list_accountsList chart of accounts (plan de cuentas)
create_paymentRecord a payment against an invoice
update_customerUpdate an existing customer's data
delete_customerDelete a customer
get_customer_balanceGet the current account balance (cuenta corriente) for a customer
list_suppliersList suppliers (proveedores)
create_supplierCreate a supplier (proveedor)
cancel_invoiceCancel/void an invoice (anular comprobante)
get_invoice_pdfGet the PDF representation of an invoice (returns URL or base64)
create_receiptCreate a receipt (recibo) — record cash/transfer received against one or more invoices
list_receiptsList receipts (recibos)
get_stockGet current stock for a product across warehouses
list_warehousesList warehouses (depósitos)
list_companiesList companies (empresas) accessible to the current API user
sales_reportSales report by date range
expenses_reportExpenses/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 Colppy
  • COLPPY_COMPANY_ID (required) — Company identifier

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

License

MIT

Source: packages/argentina/colppy/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-alpha.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts