Colppy

v0.2.0-alpha.1API Keyalpha

Argentine cloud accounting with AFIP electronic invoicing. Your agent manages facturas, customers, and tax compliance in ARS.

22 tools2 env vars🇦🇷 Argentinaalpha — pending validation

Install

terminal

$ npm install @codespar/mcp-colppy@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "colppy": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-colppy@alpha"
      ],
      "env": {
        "COLPPY_API_KEY": "<your_colppy_api_key>",
        "COLPPY_COMPANY_ID": "<your_colppy_company_id>"
      }
    }
  }
}

After restart, your agent can call any of the 22 tools below — try list_customers first.

Environment variables · 2

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

COLPPY_API_KEY

requiredsecret

API key for Colppy

COLPPY_COMPANY_ID

required

Company identifier

Available tools · 22

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READlist_customers

List customers

WRITEcreate_customer

Create a customer

READlist_products

List products and services

WRITEcreate_invoice

Create an invoice (integrates with AFIP for electronic invoicing)

READlist_invoices

List invoices

READget_balance

Get account balance summary

READlist_accounts

List chart of accounts (plan de cuentas)

WRITEcreate_payment

Record a payment against an invoice

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.