{
  "markdown": "> This repo contains the public manifest/docs for a hosted service — the full implementation runs in production as part of Velora.\n\n# Velora — Argentine Commerce MCP\n\n> ⚠️ **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.\n\n**A hosted, multi-capability commerce toolkit for Argentina — real AFIP invoicing, MercadoPago, logistics, catalog and WhatsApp behind one authenticated endpoint.**\n\nVelora is a hosted [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI agents tools to operate commerce in Argentina: fiscal invoicing (AFIP/ARCA), payments (MercadoPago), logistics (Andreani / PedidosYa), catalog, cash register, and WhatsApp messaging — authenticated and tenant-isolated.\n\n> Other AFIP MCP servers exist (some emit invoices, some only search the docs). Velora's angle is the **bundle**: fiscal is one of several commerce rails — payments, logistics, catalog, messaging — exposed through a single hosted, authenticated endpoint, so an agent runs a whole Argentine business, not just invoicing.\n\n## Endpoint\n\n```\nhttps://tools.somosvelora.com/api/mcp\n```\n\nTransport: streamable HTTP. Auth: API key (per-tenant HMAC) or OAuth 2.1 (WorkOS bearer). Any MCP client — Claude, OpenAI, Gemini, Cursor, or your own agent — consumes the same endpoint.\n\n**Free during early access.** No usage cost while we onboard the first builders — the fiscal and pure tools run no LLM on our side, so it stays cheap to keep open.\n\n## Connect\n\nPoint any MCP client that supports a remote **streamable HTTP** server at the endpoint, with your credentials as headers:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"velora\": {\n      \"type\": \"http\",\n      \"url\": \"https://tools.somosvelora.com/api/mcp\",\n      \"headers\": {\n        \"X-API-Key\": \"<your-key>\",\n        \"X-Business-Id\": \"<your-business-id>\"\n      }\n    }\n  }\n}\n```\n\nThe exact config key (`type`/`transport`) varies by client — use your client's remote/HTTP MCP server format. Request access at [somosvelora.com](https://somosvelora.com).\n\nThe pure fiscal helpers (`validate_cuit`, `split_iva`, and the rest) are also available **without authentication** at `https://tools.somosvelora.com/api/mcp/public`.\n\n## Tool packs\n\n| Pack | What it does |\n|------|--------------|\n| **Fiscal (AFIP/ARCA)** | `emit_invoice` (real CAE — Factura A/B/C + Consumidor Final), `consultar_comprobante` / `consultar_padron` (invoice + taxpayer lookup), `get_fiscal_readiness`. `emit_nota` (NC/ND): **sandbox only today — real credit/debit-note emission is in progress.** |\n| **Pure (always on)** | `validate_cuit`, `validate_cuil`, `validate_cbu`, `build_afip_qr`, `format_ars`, `to_afip_date`, `split_iva`, `describe_invoice_type`, `parse_ar_amount` |\n| **Payments** | MercadoPago links, tracked payments, payment-intent status |\n| **Logistics** | quote / create / track shipments (Andreani, PedidosYa) |\n| **Catalog & Stock** | create / edit / delete products, stock load, bulk price update |\n| **Sales & Cash** | register sales, returns, cash-register movements and balance |\n| **Customers & Suppliers** | find / upsert customers, supplier management |\n| **Messaging** | WhatsApp text & template sends |\n| **Reports** | `query_sales` — sales analytics |\n| **Connection** | `connection_status` — per-integration setup state (call this first) |\n\n> **Maturity / what's live.** `emit_invoice` (Factura A/B/C + Consumidor Final), the lookup tools, and the Pure tools are production-verified against real AFIP. `emit_nota` (NC/ND) currently emits in **sandbox only** — real credit/debit-note emission is not yet wired (it returns `sandbox: true`, never a fake CAE). Payments, Logistics and Messaging are real tools that require **per-tenant credential onboarding** (connect MercadoPago / Andreani / WhatsApp) — until a tenant connects them they return demo data or fail gracefully, so don't wire them into a production flow before onboarding. `emit_invoice` issues a real CAE only once ARCA onboarding is complete (check with `get_fiscal_readiness`); otherwise it returns a clearly-flagged sandbox response (`sandbox: true`), never a fake CAE presented as real.\n\nFull machine-readable catalog — list every tool with a `tools/list` call against the public endpoint (no auth):\n\n```bash\ncurl -s https://tools.somosvelora.com/api/mcp/public \\\n  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}'\n```\n\n## Why a managed layer\n\nAFIP's web services (WSAA + WSFE) are notoriously painful: attached PKCS#7 CMS signing, weak-DH TLS handshakes, per-CUIT certificate and token management, and a stream of new resolutions (e.g. RG 5616). Velora absorbs all of it behind clean, agent-native tool calls so you don't reimplement the fiscal stack — the same reason developers reach for managed layers over government tax APIs elsewhere in LATAM.\n\n## Status\n\n- ✅ Real AFIP invoicing verified in production (live CAE issuance for an onboarded tenant).\n- ✅ MercadoPago payments and the pure validation/formatting tools are live.\n- 🔧 Logistics & messaging require per-tenant credential onboarding (see **Maturity** above).\n\n## Links\n\n- Site: [somosvelora.com](https://somosvelora.com)\n- Toolkit endpoint: [tools.somosvelora.com](https://tools.somosvelora.com)\n- Blog (AFIP integration field notes): [somosvelora.com/blog](https://somosvelora.com/blog) — ⚠️ currently returns 404 while the site's `/blog` route is down\n\n---\n\nThis repository is the public manifest and documentation for the Velora MCP server. The server itself is hosted; this repo carries the `server.json` registry manifest and connection docs.\n\n> Built by directing Claude Code — scoped, generated, and verified at runtime. The method is the point — the same one behind 2 fixes merged into [Mastra](https://github.com/mastra-ai/mastra) (26k★ TS AI-agent framework): [#19604](https://github.com/mastra-ai/mastra/pull/19604), [#19610](https://github.com/mastra-ai/mastra/pull/19610).\n",
  "bytes": 6221,
  "sha": "e0e7b3af50b5b1d14f3d592e357f7417c2aa9ca418ae1396e08970df87efa3c6",
  "repo_slug": "crossi-dev/velora-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_somosvelora_velora_ffba2558/readme"
}