Velora

by crossi-dev

Not rated
GitHub

About

Hosted MCP server for Argentine commerce — real AFIP fiscal invoicing + MercadoPago payments (live), catalog, sales & WhatsApp; a public no-auth endpoint exposes 9 fiscal utility tools.

Details

Author
crossi-dev
Categories
Finance, Security, Other, Communication

Setup

Install Velora in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/crossi-dev/velora-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

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, sotools.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 hostedModel Context Protocolserver 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 thebundle: 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 remotestreamable HTTPserver at the endpoint, with your credentials as headers:

{ "mcpServers": { "velora": { "type": "http", "url": "https://tools.somosvelora.com/api/mcp", "headers": { "X-API-Key": "<your-key>", "X-Business-Id": "<your-business-id>" } } } }

The exact config key (type/transport) varies by client — use your client's remote/HTTP MCP server format. Request access atsomosvelora.com.

The pure fiscal helpers (validate_cuit,split_iva, and the rest) are also availablewithout authenticationathttps://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 insandbox 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 requireper-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 atools/listcall against the public endpoint (no auth):

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

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.

- ✅ Real AFIP invoicing verified in production (live CAE issuance for an onboarded tenant).
- ✅ MercadoPago payments and the pure validation/formatting tools are live.
- 🔧 Logistics & messaging require per-tenant credential onboarding (seeMaturityabove).

- Site:somosvelora.com
- Toolkit endpoint:
tools.somosvelora.com
- Blog (AFIP integration field notes):
somosvelora.com/blog— ⚠️ currently returns 404 while the site's/blogroute is down

This repository is the public manifest and documentation for the Velora MCP server. The server itself is hosted; this repo carries theserver.jsonregistry 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 intoMastra(26k★ TS AI-agent framework):#19604,#19610.

Agent-native forum for the x402/A2A ecosystem. The hosted MCP server exposes the whole forum as tools — threads, comments, votes, USDC bounties (Coinbase x402 on Base), provider reviews, and search. Endpoint: https://api.achivx.com/mcp/ (HTTP, OAuth 2.1).

Agent identity and key custody — provider keys held in a local encrypted vault and leased to agents under owner approvals, with env-var injection so secrets never enter model context and a one-command kill switch; plus a registry with Ed25519 agent identity, reputation, and messaging.

Voice MCP server: voice-cloning TTS/STT with speak, talk, voice inbox and feeds - remote MCP with OAuth at mcp.koe.live

Postgate AI - Microsoft Exchange MCP Server

Hosted multi-user MCP server for Microsoft Exchange - including Exchange Server on-premises and hybrid (EWS): 70+ tools for mail, calendar, contacts and tasks over SSE/Streamable HTTP with OAuth 2.0/PKCE.

Hosted, read-only Twitter/X data for AI agents via OAuth—search tweets, profiles, followers, lists, communities, and spaces, with 100 free requests for new accounts.

Personal wealth & portfolio tracker — 23 OAuth-scoped tools for holdings, performance, FIRE status, crypto P&L, and confirm-gated transaction writes across 20+ markets.

Live Bank of England data over MCP — base rate (current, history, stats), any IADB series (SONIA, FX, mortgage rates), and MPC meeting dates. No auth required.

Cenogram - Polish Real Estate Transactions (RCN)

Polish real estate transaction prices from notarial deeds, not listings - 8M+ records from the national RCN registry, 2003 to present, with OAuth 2.1.

Open-source personal finance app whose MCP server gives AI assistants 54 tools to query and manage accounts, transactions, budgets, investments, loans and net worth. Self-hosted or hosted, with OAuth 2.1.

Grade any bet against thousands of play-by-play game simulations — true win probability, implied odds, and edge for every leg.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.