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":{}}'