velora

このリポジトリには、ホステッドサービスの公開マニフェストとドキュメントが含まれています。完全な実装は、Velora の一部として本番環境で稼働します。

Velora — アルゼンチンのコマース MCP

⚠️ ホステッドエンドポイントは一時的にオフラインです。 接続先のサービスが一時停止中のため、現在 tools.somosvelora.com は 404 を返します。マニフェストと以下のツールの仕様は引き続き正確ですが、復旧するまで URL から応答はありません。ここにあるものは放棄されていません。ドキュメントは意図的に正確な状態に保たれています。

アルゼンチン向けのホステッド型・多機能コマースツールキットです。実際の AFIP 請求、MercadoPago、物流、カタログ、WhatsApp を、認証付きの単一エンドポイントから利用できます。

Velora は、AI エージェントにアルゼンチンのコマースを運用するツールを提供する、ホステッド型の Model Context Protocol サーバーです。財務請求（AFIP/ARCA）、決済（MercadoPago）、物流（Andreani / PedidosYa）、カタログ、レジ、WhatsApp メッセージングを、認証およびテナントごとの分離を備えた形で利用できます。

他にも AFIP MCP サーバーは存在します（請求書を発行するものも、ドキュメントを検索するだけのものもあります）。Velora の特徴は一括提供です。財務機能は、決済、物流、カタログ、メッセージングと並ぶ複数のコマース機能のひとつとして、ホステッド型の認証付き単一エンドポイントから利用できます。そのため、エージェントは請求だけでなく、アルゼンチンのビジネス全体を運用できます。

エンドポイント

https://tools.somosvelora.com/api/mcp

トランスポート：ストリーミング可能な HTTP。認証：API キー（テナントごとの HMAC）または OAuth 2.1（WorkOS bearer）。Claude、OpenAI、Gemini、Cursor、自作のエージェントなど、あらゆる MCP クライアントが同じエンドポイントを利用できます。

早期アクセス期間中は無料です。 最初の開発者を受け入れている間は、利用料はかかりません。財務ツールと純粋なツールでは、こちら側で LLM を実行しないため、低コストで公開を続けられます。

接続

リモートのストリーミング可能な HTTP サーバーに対応する任意の MCP クライアントを、エンドポイントに接続し、ヘッダーに認証情報を指定してください。

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

設定キー（type/transport）はクライアントによって異なります。お使いのクライアントのリモート／HTTP MCP サーバー形式を使用してください。アクセスをリクエストするには、somosvelora.com をご覧ください。

純粋な財務ヘルパー（validate_cuit、split_iva など）も、https://tools.somosvelora.com/api/mcp/public で認証なしで利用できます。

ツールパック

パック	内容
Fiscal (AFIP/ARCA)	emit_invoice（実際の CAE — Factura A/B/C ＋ Consumidor Final）、consultar_comprobante / consultar_padron（請求書と納税者の照会）、get_fiscal_readiness。emit_nota（NC/ND）：現在はサンドボックスのみ — 実際のクレジットノート／デビットノートの発行は対応作業中です。
Pure（常時利用可能）	validate_cuit、validate_cuil、validate_cbu、build_afip_qr、format_ars、to_afip_date、split_iva、describe_invoice_type、parse_ar_amount
Payments	MercadoPago のリンク、追跡対象の支払い、支払いインテントのステータス
Logistics	配送の見積もり／作成／追跡（Andreani、PedidosYa）
Catalog & Stock	商品の作成／編集／削除、在庫の登録、一括価格更新
Sales & Cash	売上、返品、レジの入出金と残高の登録
Customers & Suppliers	顧客の検索／登録・更新、サプライヤー管理
Messaging	WhatsApp のテキストおよびテンプレート送信
Reports	query_sales — 売上分析
Connection	connection_status — インテグレーションごとのセットアップ状況（最初に呼び出してください）

成熟度／現在利用可能な機能。 emit_invoice（Factura A/B/C ＋ Consumidor Final）、照会ツール、Pure ツールは、実際の AFIP を使った本番環境での検証済みです。emit_nota（NC/ND）は現在、サンドボックスのみで発行します — 実際のクレジットノート／デビットノートの発行はまだ接続されていません（sandbox: true を返し、偽の CAE を返すことはありません）。Payments、Logistics、Messaging は、テナントごとの認証情報の登録（MercadoPago／Andreani／WhatsApp の接続）が必要な実際のツールです — テナントが接続するまではデモデータを返すか、適切にエラーを処理するため、登録前に本番ワークフローへ組み込まないでください。emit_invoice が実際の CAE を発行するのは、ARCA のオンボーディングが完了した後のみです（get_fiscal_readiness で確認してください）。未完了の場合は、明確にフラグが付いたサンドボックス応答（sandbox: true）を返し、実際のものとして偽の CAE を返すことはありません。

機械可読なカタログ全体 — 認証不要で公開エンドポイントに対して tools/list を呼び出すと、すべてのツールを一覧表示できます：

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 のウェブサービス（WSAA ＋ WSFE）は、PKCS#7 CMS 署名の組み込み、脆弱な DH による TLS ハンドシェイク、CUIT ごとの証明書とトークンの管理、相次ぐ新たな規則（例：RG 5616）など、非常に扱いにくいことで知られています。Velora はこれらすべてを、エージェント向けに設計されたシンプルなツール呼び出しの背後で処理するため、財務関連の仕組みを再実装する必要がありません。LATAM の他の地域で政府の税務 API を利用する際に、開発者がマネージドレイヤーを選ぶのと同じ理由です。

ステータス

• ✅ 本番環境で実際の AFIP 請求書発行を検証済み（オンボーディング済みテナントで CAE を実際に発行）。
• ✅ MercadoPago の支払いと Pure の検証／書式設定ツールを利用可能です。
• 🔧 Logistics と Messaging はテナントごとの認証情報の登録が必要です（上記の成熟度を参照）。

リンク

• サイト：somosvelora.com
• ツールキットのエンドポイント：tools.somosvelora.com
• ブログ（AFIP 連携に関する現場ノート）：somosvelora.com/blog — ⚠️ サイトの /blog ルートが停止中のため、現在 404 を返します

---

このリポジトリは、Velora MCP サーバーの公開マニフェストとドキュメントです。サーバー自体はホストされており、このリポジトリには server.json のレジストリマニフェストと接続ドキュメントが含まれています。

Claude Code に指示して構築 — 対象範囲を限定し、生成し、実行時に検証しています。その手法こそが重要です — Mastra（26k★の TypeScript AI エージェントフレームワーク）にマージされた 2 件の修正の背景にあるのも同じ手法です： #19604、#19610。