Skip to content

crossi-dev/latam-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Velora LATAM Tools — MCP Server

Pure, no-auth tools for AI agents operating in Argentina.

Argentine tax ID validation, AFIP/ARCA fiscal QR generation, amount parsing, and IVA splitting — without any account, API key, or installation required.


What this is

A remote MCP server that exposes 4 pure tools for Argentine business operations. Any MCP-compatible AI agent can connect and call these tools directly over Streamable HTTP.

Server name: io.github.crossi-dev/latam-tools
Transport: Streamable HTTP
Endpoint: https://tools.somosvelora.com/api/mcp/public
Auth required: None
Install required: None


Tools

Tool What it does
validate_cuit Validates Argentine CUIT or CUIL. Returns whether valid, entity type (persona física/jurídica), check-digit verification.
build_afip_qr Generates an AFIP/ARCA fiscal QR code for electronic invoices (Res. Gral. 4291-E). Returns base64 PNG + raw URL.
parse_ar_amount Parses Argentine amount strings (e.g. "$1.250,50" or "1250.50") to a canonical float. Handles both AR and US number formats.
split_iva Splits a gross amount into net + IVA breakdown for Argentine fiscal rates (10.5%, 21%, 27%, 0%).

All tools are stateless and deterministic — no side effects, no external calls, no database.


Connect

Claude Desktop

{
  "mcpServers": {
    "latam-tools": {
      "url": "https://tools.somosvelora.com/api/mcp/public"
    }
  }
}

Cursor

Add via Settings → Features → MCP → New Server:

  • Name: latam-tools
  • URL: https://tools.somosvelora.com/api/mcp/public

Any MCP client (JSON config)

{
  "type": "streamable-http",
  "url": "https://tools.somosvelora.com/api/mcp/public"
}

Example usage

Validate a CUIT:

Tool: validate_cuit
Input: { "cuit": "20-12345678-9" }
Output: { "valid": true, "type": "persona_fisica", "formatted": "20-12345678-9" }

Generate fiscal QR:

Tool: build_afip_qr
Input: {
  "cuit": "20123456789",
  "punto_de_venta": 1,
  "tipo_comprobante": 11,
  "nro_comprobante": 42,
  "importe_total": 1210.00,
  "tipo_moneda": "PES",
  "ctz": 1
}
Output: { "qr_png_base64": "...", "url": "https://www.afip.gob.ar/fe/qr/?p=..." }

Official registry

This server is listed in the official MCP Registry as io.github.crossi-dev/latam-tools.

{
  "name": "io.github.crossi-dev/latam-tools",
  "title": "Velora LATAM Tools",
  "endpoint": "https://tools.somosvelora.com/api/mcp/public",
  "transport": "streamable-http"
}

Use cases

  • AI assistants validating Argentine tax IDs before issuing invoices
  • Agents building fiscal QR codes for electronic receipts (comprobantes)
  • Chatbots parsing Argentine currency amounts from user input
  • Any LLM-powered workflow handling Argentine compliance data

About

Built by Velora — an AI-native commerce platform for Argentine businesses.

The public MCP endpoint is a subset of the Velora tool layer, exposing only pure, stateless tools that are safe for unrestricted use. No business data is read or written.


License

MIT — see LICENSE.

About

Argentina CUIT/CUIL validation and AFIP fiscal QR generation. Pure, no-auth MCP tools for AI agents.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors