This repo contains the public manifest/docs for a hosted service — the full implementation runs in production as part of Velora.

Velora LATAM Tools — MCP Server

⚠️ The hosted endpoint is temporarily offline. The service it fronts is paused, so tools.somosvelora.com returns 404 right now — the manifest and the tool contracts below are still accurate, but the URLs will not answer until it is back up. Nothing here is abandoned; the docs are kept honest on purpose.

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 9 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 parsed components, entity type (persona física/jurídica), and check-digit verification.
validate_cuil	Validates an Argentine CUIL for natural persons. Same mod-11 algorithm as validate_cuit, flags company prefixes (30/33/34) with a warning.
build_afip_qr	Builds the AFIP/ARCA fiscal QR URL for electronic invoices (RG 4291/2018). Returns the full URL string (https://www.afip.gob.ar/fe/qr/?p=<base64>) — no PNG, no image, just the URL to encode into a QR image yourself.
parse_ar_amount	Parses Argentine amount strings (e.g. "$1.250,50", "5k") to a canonical float. Handles the Argentine ./, convention plus k/K suffixes.
split_iva	Splits a gross amount into net + IVA breakdown for any of the 6 ARCA/WSFE alícuotas (0%, 2.5%, 5%, 10.5%, 21%, 27%).
format_ars	Formats a number as an Argentine peso display string (e.g. 1500.5 → "$ 1.500,50").
to_afip_date	Converts an ISO date (or "today") to YYYYMMDD WSFE format, ART-anchored.
describe_invoice_type	Looks up the A/B/C invoice type from emisor + receptor condicionIva.
validate_cbu	Validates an Argentine CBU/CVU (22-digit bank account code) via its two mod-10 check digits (BCRA Com. A 2622).

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-6" }
Output: {
  "valid": true,
  "normalized": "20123456786",
  "formatted": "20-12345678-6",
  "prefix": "20",
  "body": "12345678",
  "checkDigit": "6",
  "personType": "fisica_masculina",
  "personTypeDescription": "Persona física (masculino)."
}

Generate fiscal QR:

Tool: build_afip_qr
Input: {
  "cuit": "20123456789",
  "ptoVta": 1,
  "tipoCmp": 11,
  "nroComp": 42,
  "fecha": "2026-08-05",
  "importe": 1210.00,
  "moneda": "PES",
  "ctz": 1,
  "tipoDocRec": 99,
  "nroDocRec": 0,
  "tipoCodAut": "E",
  "codAut": "12345678901234"
}
Output: "https://www.afip.gob.ar/fe/qr/?p=eyJ2ZXIiOjEsImZlY2hhIjoiMjAyNi0wOC0wNSIsImN1aXQiOjIwMTIzNDU2Nzg5LCJwdG9WdGEiOjEsInRpcG9DbXAiOjExLCJucm9Db21wIjo0MiwiaW1wb3J0ZSI6MTIxMCwibW9uZWRhIjoiUEVTIiwiY3R6IjoxLCJ0aXBvRG9jUmVjIjo5OSwibnJvRG9jUmVjIjowLCJ0aXBvQ29kQXV0IjoiRSIsImNvZEF1dCI6MTIzNDU2Nzg5MDEyMzR9"

All 12 fields are mandatory per the AFIP spec — ptoVta, tipoCmp, nroComp, fecha, importe, moneda, ctz, tipoDocRec, nroDocRec, tipoCodAut, codAut (plus cuit). The tool only builds the URL — it does not contact AFIP, so a fabricated codAut will produce a valid-looking URL that fails verification when actually scanned.

---

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.