com.somosvelora由 somosvelora.com 发布官方发布者v1.0.1更新于 Oct 24, 2026
Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
面向阿根廷商户的托管 MCP 服务器：AFIP/ARCA 开票、MercadoPago 收款、物流、商品目录、收银与 WhatsApp 消息。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/com.somosvelora%2Fvelora/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"velora": {
"type": "http",
"url": "https://tools.somosvelora.com/api/mcp"
}
}
}This repo contains the public manifest/docs for a hosted service — the full implementation runs in production as part of Velora.
⚠️ The hosted endpoint is temporarily offline. The service it fronts is paused, so
tools.somosvelora.comreturns 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.
A hosted, multi-capability commerce toolkit for Argentina — real AFIP invoicing, MercadoPago, logistics, catalog and WhatsApp behind one authenticated endpoint.
Velora is a hosted Model Context Protocol 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.
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.
Transport: 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.
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.
Point any MCP client that supports a remote streamable HTTP server at the endpoint, with your credentials as headers:
The exact config key (type/transport) varies by client — use your client's remote/HTTP MCP server format. Request access at somosvelora.com.
The pure fiscal helpers (validate_cuit, split_iva, and the rest) are also available without authentication at https://tools.somosvelora.com/api/mcp/public.
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 returnssandbox: 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_invoiceissues a real CAE only once ARCA onboarding is complete (check withget_fiscal_readiness); otherwise it returns a clearly-flagged sandbox response (sandbox: true), never a fake CAE presented as real.
Full machine-readable catalog — list every tool with a tools/list call against the public endpoint (no auth):
AFIP'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.
/blog route is downThis 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.
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 (26k★ TS AI-agent framework): #19604, #19610.
来源：README.md，提交 81d18b5
Validate CUIT/CUIL
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.
cuit必填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.
无需输入参数。
Emit invoice (ARCA)
[demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code.
tipo必填conceptamountARS必填requestIdcustomerCuit必填Emit credit/debit note (ARCA)
[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.
kind必填tipo必填conceptamountARS必填requestIdcustomerCuit必填associatedInvoice必填Create product
[demo: deshabilitada] Creates a new product in the business catalog. Requires name and price.
name必填price必填costPriceweightGramsinitialStockEdit product
[demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity).
namepricecostPriceproductId必填stockQuantityStock load
[demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail.
itemName必填quantity必填productIdunitPricesupplierIdsupplierNameautoCreateProductcreatePurchaseRequestAdjust stock
[demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail).
mode必填quantity必填productId必填Delete product
[demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog.
productId必填Bulk price update
[demo: deshabilitada] Mass price change for all products or a specified subset in this business.
mode必填amount必填direction必填productIdsQuery catalog
Lists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.
searchOpen catalog selector
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).
searchRegister sale
[demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice.
items必填requestIdcustomerIdpaymentMethodRegister cash movement
[demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment').
datetype必填amount必填description必填Return sale
[demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible.
countconfirm必填cutoffHoursFind customer
Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.
namephoneUpsert customer
[demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business.
citynameemailphoneaddresscustomerIdpostalCodeDelete customer
[demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices).
customerId必填Quote shipping
Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.
weightGrams必填declaredValueoriginPostalCode必填destinationPostalCode必填Create shipment
[demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL.
saleId必填serviceprovider必填customerDniweightGrams必填customerCitycustomerName必填customerPhonecustomerAddress必填customerLastNamecustomerProvincecustomerPostalCode必填另有 1 个Track shipment
Tracks the current status and event history of a shipment by tracking number.
provider必填trackingNumber必填Get package profile
Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.
saleIdproductIdsweightGramsOverrideSend WhatsApp text
[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).
to必填text必填mediaUrlSend WhatsApp template
[demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window.
to必填componentslanguageCodetemplateName必填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.
无需输入参数。
Consult cash balance
Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.
无需输入参数。
Open or close cash shift
[demo: deshabilitada] Opens or closes a cash register shift for the authenticated business.
notamonto必填action必填Register cash movement (caja)
[demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll.
tipo必填monto必填descripcion必填Get payment intent status
Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.
customerNamepaymentIntentIdOpen payment link wizard
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).
items必填customerIddescription必填Open pending orders
Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.
无需输入参数。
Open cobro status
Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.
customerNamepaymentIntentIdOpen delivery receipt
Opens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.
saleIdcustomerNamepaymentIntentIdCreate tracked payment link
[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.
items必填customerId必填description必填expiresInDaysidempotencyKey必填List suppliers
Returns all suppliers for this business (up to 50, sorted by name).
searchCreate supplier
[demo: deshabilitada] Creates a supplier for this business.
name必填emailphonecontactNameleadTimeDaysCreate purchase request
[demo: deshabilitada] Creates a procurement order (purchase request) to a supplier.
itemName必填quantity必填unitPrice必填supplierIdsupplierNameEdit supplier
[demo: deshabilitada] Updates an existing supplier's fields.
nameemailphonesupplierId必填contactNameleadTimeDaysDelete supplier
[demo: deshabilitada] Deletes a supplier from this business (with full audit trail).
supplierId必填Query sales
Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.
tofromlimitpresetmetrica必填customer_nameConnect MercadoPago
[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.
accessTokenConnect PedidosYa
[demo: deshabilitada] Connects PedidosYa for this business using the BYOA secure-form model. Primary: returns a secure link. Fallback: accepts an API token directly.
apiTokenConnect WhatsApp
[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.
phoneConnect Tienda Nube
[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.
无需输入参数。
Upload catalog
[demo: deshabilitada] Bulk-creates products in the business catalog from a structured list (up to 50 items).
products必填Open sale confirmation
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.
items必填customerIdOpen caja status
Opens a visual widget showing the current shift state and action buttons. Read-only here.
无需输入参数。
Open onboarding hub
Opens a graphical onboarding hub showing integration status and connect links. Read-only.
无需输入参数。
Open business overview
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.
defaultTabcustomerNameOpen shipment prep
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.
items必填declaredValueoriginPostalCode必填destinationPostalCode必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
https://tools.somosvelora.com/api/mcp{ "mcpServers": { "velora": { "type": "http", "url": "https://tools.somosvelora.com/api/mcp", "headers": { "X-API-Key": "<your-key>", "X-Business-Id": "<your-business-id>" } } }}curl -s https://tools.somosvelora.com/api/mcp/public \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'