mcp server

velora

Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.

Description as published by the maintainer. Source

• version 1.0.1
• active

active — Most recent push to the repository was 2026-08-05.

What this server can do

50 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

adjust_stock(mode, quantity, productId)

[demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail). Required: productId, mode, quantity.

bulk_price_update(mode, amount, direction, productIds)

[demo: deshabilitada] Mass price change for all products or a specified subset in this business. Required: amount, mode, direction.

caja_ciclo_caja(nota, monto, action)

[demo: deshabilitada] Opens or closes a cash register shift for the authenticated business. Required: action, monto.

caja_consultar_saldo

Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.

caja_registrar_movimiento(tipo, monto, descripcion)

[demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll. Required: tipo, monto, descripcion.

connect_mercadopago(accessToken)

[demo: deshabilitada] Connects MercadoPago for this business using the BYOA OAuth-redirect model. Primary: returns an authorization URL. Fallback: accepts a production access token directly.

connect_pedidosya(apiToken)

[demo: deshabilitada] Connects PedidosYa for this business using the BYOA secure-form model. Primary: returns a secure link. Fallback: accepts an API token directly.

connect_tiendanube

[demo: deshabilitada] Connects Tienda Nube (Nuvemshop) using the BYOA OAuth-redirect model. Returns an authorization URL — no token ever passes through chat. Gated behind env config in production.

connect_whatsapp(phone)

[demo: deshabilitada] Connects WhatsApp Business using the BYOA Meta Embedded Signup model. Primary: returns a signup link. Optional: registers a phone number as a lightweight pre-step.

connection_status

Returns the BYOA (Bring Your Own Account) integration readiness for the authenticated business — what is connected and how to connect what is missing. Read-only.

create_product(name, price, costPrice, weightGrams, initialStock)

[demo: deshabilitada] Creates a new product in the business catalog. Requires name and price. Required: name, price.

create_purchase_request(itemName, quantity, unitPrice, supplierId, supplierName)

[demo: deshabilitada] Creates a procurement order (purchase request) to a supplier. Required: itemName, quantity, unitPrice.

create_shipment(saleId, service, provider, customerDni, weightGrams, customerCity, customerName, customerPhone, customerAddress, customerLastName, customerProvince, customerPostalCode, customerAddressNumber)

[demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL. Required: provider, saleId, customerName, customerAddress, customerPostalCode, weightGrams.

create_supplier(name, email, phone, contactName, leadTimeDays)

[demo: deshabilitada] Creates a supplier for this business. Required: name.

create_tracked_payment_link(items, customerId, description, expiresInDays, idempotencyKey)

[demo: deshabilitada] Creates a tracked MercadoPago payment link for a catalog-tied cobro: atomically records the Sale + Invoice + PaymentIntent, then generates a real Checkout Pro link. MONEY: real and irreversible. Required: customerId, items, description, idempotencyKey.

delete_customer(customerId)

[demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices). Required: customerId.

delete_product(productId)

[demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog. Required: productId.

delete_supplier(supplierId)

[demo: deshabilitada] Deletes a supplier from this business (with full audit trail). Required: supplierId.

edit_product(name, price, costPrice, productId, stockQuantity)

[demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity). Required: productId.

edit_supplier(name, email, phone, supplierId, contactName, leadTimeDays)

[demo: deshabilitada] Updates an existing supplier's fields. Required: supplierId.

emit_invoice(tipo, concept, amountARS, requestId, customerCuit)

[demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code. Required: customerCuit, amountARS, tipo.

emit_nota(kind, tipo, concept, amountARS, requestId, customerCuit, associatedInvoice)

[demo: deshabilitada] Emits an ARCA-compliant Nota Crédito (NC) or Nota Débito (ND) against an original AFIP invoice and returns the CAE authorization code. Required: customerCuit, amountARS, tipo, kind, associatedInvoice.

find_customer(name, phone)

Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.

get_fiscal_readiness

Checks whether the business is ready to emit real ARCA electronic invoices. Returns { ready, missing, guidance } where ready=true means all fiscal fields and the ARCA certificate are configured.

get_package_profile(saleId, productIds, weightGramsOverride)

Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.

get_payment_intent_status(customerName, paymentIntentId)

Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.

list_suppliers(search)

Returns all suppliers for this business (up to 50, sorted by name).

open_business_overview(defaultTab, customerName)

ONE widget, two display modes: inline snapshot by default, fullscreen tabs (Cliente 360, Cerrar el día, Reposición de stock, Dashboard de ventas) on demand. Aggregates caja, payments, ventas, reportes, supplier, and customer reads.

open_caja_status

Opens a visual widget showing the current shift state and action buttons. Read-only here.

open_catalog_selector(search)

Opens the catalog selector — a graphical product picker (MCP Apps widget) that shows active products with prices (ARS) and stock. Side-effect-free (no sale, no charge).

open_cobro_status(customerName, paymentIntentId)

Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.

open_delivery_receipt(saleId, customerName, paymentIntentId)

Opens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.

open_onboarding

Opens a graphical onboarding hub showing integration status and connect links. Read-only.

open_payment_link_wizard(items, customerId, description)

Opens the payment-link wizard — a graphical form pre-filled with the cobro, for the owner to review and confirm before any money moves. Side-effect-free (no charge). Required: description, items.

open_pending_orders

Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.

open_sale_confirm(items, customerId)

Opens a VISUAL preview of a cash sale — resolved product names, unit prices, quantities, and total — with a confirm button that fires register_sale. Read-only preview itself. Required: items.

open_shipment_prep(items, declaredValue, originPostalCode, destinationPostalCode)

Combines catalog stock/weight data and a live shipping quote into one widget — resolves items, computes total weight, and quotes couriers. Read-only, side-effect-free. Required: items, originPostalCode, destinationPostalCode.

query_catalog(search)

Lists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.

query_sales(to, from, limit, preset, metrica, customer_name)

Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'. Required: metrica.

quote_shipping(weightGrams, declaredValue, originPostalCode, destinationPostalCode)

Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending. Required: originPostalCode, destinationPostalCode, weightGrams.

register_movement(date, type, amount, description)

[demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment'). Required: type, description, amount.

register_sale(items, requestId, customerId, paymentMethod)

[demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice. Required: items.

return_sale(count, confirm, cutoffHours)

[demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible. Required: confirm.

send_whatsapp_template(to, components, languageCode, templateName)

[demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window. Required: to, templateName.

send_whatsapp_text(to, text, mediaUrl)

[demo: deshabilitada] Sends a plain-text WhatsApp message to a customer phone number. Only valid inside the 24-hour customer-service window (Meta error 131026 outside). Required: to, text.

stock_load(itemName, quantity, productId, unitPrice, supplierId, supplierName, autoCreateProduct, createPurchaseRequest)

[demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail. Required: itemName, quantity.

track_shipment(provider, trackingNumber)

Tracks the current status and event history of a shipment by tracking number. Required: trackingNumber, provider.

upload_catalog(products)

[demo: deshabilitada] Bulk-creates products in the business catalog from a structured list (up to 50 items). Required: products.

upsert_customer(city, name, email, phone, address, customerId, postalCode)

[demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business.

validate_cuit(cuit)

Validates an Argentine CUIT or CUIL number. Returns parsed components (prefix, body, check digit), person type, and whether the check digit is mathematically correct. Accepts any format: raw digits, hyphened (20-12345678-9), or spaced. This tool runs the REAL check-digit algorithm — not a demo fixture. Required: cuit.

Last successful function declaration observed on 2026-08-13. Source: https://tools.somosvelora.com/api/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://tools.somosvelora.com/api/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/crossi-dev/velora-mcp
• Website — https://somosvelora.com
• Remote endpoint (streamable-http) — https://tools.somosvelora.com/api/mcp

Related, by what their authors tagged them

• io.github.ar-agents/mcp — last commit 2026-08-03, shares afip, argentina, mercadopago
  Argentine business automation: Mercado Pago, AFIP/ARCA, WhatsApp, banking, shipping (7 packages).
• MCP E-Invoicing Core — last commit 2026-07-15, shares electronic-invoicing
  Base package for European e-invoicing MCP servers with shared models, XML utils, and OAuth2 client.
• io.github.cmendezs/mcp-facturacion-electronica-es — last commit 2026-07-10, shares facturacion-electronica
  Spanish e-invoicing MCP server: VERI*FACTU, Facturae/FACe, SII, Crea y Crece B2B.
• br.com.brasilnfe/fiscal — last commit 2026-06-12, shares fiscal
  Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
• MCP Fiscal Brasil — last commit 2026-08-04, shares fiscal
  Ferramentas fiscais brasileiras: CNPJ, NF-e, IBS/CBS, ICMS, Simples Nacional, NCM/CFOP. Sem API key.
• ai.epinu/epinu — last commit 2026-07-29, shares agentic-commerce
  Agent-first marketplace for industrial assets & livestock medianería; humans approve every write.
• Myagi - Open Agent Registry — last commit 2026-08-03, shares agentic-commerce
  Score any website's AI-agent readiness. Open Agent Registry scanner + platform tools.
• Sivut SEC Crypto Filing Radar — last commit 2026-06-09, shares agentic-commerce
  SEC EDGAR crypto filing radar MCP with x402-paid Base USDC data URLs.
• Eveoy — Verified In-Store Foot Traffic ($24.99/customer) — last commit 2026-07-16, shares agentic-commerce
  Your Eveoy expert in any AI — learn how it works, get a price, and order real in-store visits.
• HemmaBo Host Booking Engine — last commit 2026-08-06, shares agentic-commerce
  Host-owned vacation-rental direct booking via VRP. Signed offers, 0% commission. Not an OTA.

These share tags the maintainers applied themselves, such as afip, argentina, mercadopago, electronic-invoicing. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: afip, agentic-commerce, arca, argentina, electronic-invoicing, facturacion-electronica, fiscal, mcp, mcp-server, mercadopago, model-context-protocol.