VaultAlexa+
Enables querying highly-rated Amazon deals and executing automated smart purchase plans with Subscribe & Save discounts, subject to budget checks.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
VaultAlexa+ โ Alexa+ Smart Personal Financial & Intelligent Shopping Agent
Enterprise-grade autonomous AI financial advisor and intelligent Amazon shopping assistant โ powered by Model Context Protocol (MCP) Spec 2025-11-25 over JSON-RPC 2.0 Streamable HTTP.
๐ฌ Watch Demo Video ยท ๐ Quickstart ยท ๐ ๏ธ MCP Tools Reference ยท ๐งช Testing Guide for Judges ยท ๐๏ธ Architecture ยท ๐ Friction Log
๐ฌ Watch Live Product Demo Video (3 Minutes)

๐ Click the banner above to watch the full demonstration on YouTube: https://www.youtube.com/watch?v=U0SNEII29Cg

๐ Overview
VaultAlexa+ is a Two-Sided Bilateral AI Agent bridging Consumers (Buyers) with the Amazon Seller Ecosystem:
๐ For Buyers | ๐ช For Sellers |
Pre-purchase safety validation against monthly budgets | FBA inventory stockout prediction & PO drafting |
Proactive deficit risk forecast (upcoming bills radar) | Real-time sales analytics & revenue intelligence |
1-Click Alexa+ Voice Purchasing with budget guards | Dynamic repricing strategy & Buy Box optimization |
Bilateral AI negotiation for instant discount vouchers | AI-powered product listing generation from photos |
Anti-impulse cooldown & opportunity cost simulation | Incoming orders dispatch monitoring |
Household bill splitting via Alexa Contacts | Multimodal product catalog publishing |
Price drop sniper & deal watchlist | โ |
Related MCP server: Signal402 Payment Guard
๐ธ Screenshots
๐ Financial Dashboard & Alexa+ Chat | ๐๏ธ Intelligent Amazon Shopping Assistant |
|
|
๐ Interactive MCP Protocol Inspector | ๐ค AI Negotiation & Anti-Impulse Guard |
|
|
๐ Key Highlights
15 MCP Tools (far exceeding the minimum 5 required)
3 MCP Resources (
vault://URI scheme)2 Reusable Prompts (financial audit, deal negotiation)
Full Bilingual โ EN (
US) and Bahasa Indonesia (ID) with dynamic switchingVisual Reasoning Trace โ real-time agentic chain-of-thought visible to judges
Human-in-the-Loop โ Seller can review, edit, and approve AI-generated product listings before publishing
Multimodal AI Vision โ Gemini 2.0 Flash analyzes uploaded product photos to generate Amazon listings
๐ Quickstart
Option A โ Zero Dependency: Open in Browser Directly
No installation needed. Open the web simulator instantly:
# Windows
start index.html
# macOS / Linux
open index.htmlOption B โ Run MCP Node.js Server (for Judge MCP Inspector)
# 1. Clone repository
git clone https://github.com/karyalangitdigital/vault-alexa-mcp.git
cd vault-alexa-mcp
# 2. Install dependencies
npm install
# 3. Start MCP server
npm start
# Server is now running at http://localhost:3000
# 4. Open web simulator
# Navigate browser to: http://localhost:3000MCP Endpoints:
JSON-RPC 2.0:
POST http://localhost:3000/mcp/v1/rpcServer-Sent Events:
GET http://localhost:3000/mcp/v1/sseHealth Check:
GET http://localhost:3000/health
Option C โ Run Tests (for Judge Verification)
npm test # MCP JSON-RPC 2.0 compliance test (9 methods)
npm run test:dom # DOM sync & state consistency test
npm run test:all # Full test suite๐ ๏ธ MCP Tools Reference (15 Tools)
All tools conform to MCP Specification 2025-11-25 and are callable via tools/call JSON-RPC 2.0.
๐ Buyer Tools
# | Tool Name | Description | Key Args |
1 |
| Real-time budget status, account balances & category breakdown |
|
2 |
| Intelligent Amazon Prime deal discovery with sorting & filters |
|
3 |
| Pre-purchase safety check against remaining category budget |
|
4 |
| Register deal sniper / price drop alert watchdog |
|
5 |
| Split household expenses via Alexa Contacts |
|
6 |
| Append a financial transaction to the personal vault ledger |
|
7 |
| Bilateral buyer-seller real-time discount negotiation bridge |
|
8 |
| Anti-impulse guard: projects savings goal delay from purchase |
|
9 |
| Proactive deficit risk forecast using upcoming obligation radar |
|
10 |
| Full-lifecycle RMA dispute, return label & instant escrow refund |
|
11 |
| Dispatch Alexa voice bill-split notifications to household contacts |
|
๐ช Seller Tools
# | Tool Name | Description | Key Args |
12 |
| Proactive standup: cashflow / FBA stockout / orders (role-aware) |
|
13 |
| FBA burn velocity analysis, auto PO draft & dynamic repricing |
|
14 |
| Gemini 2.0 Flash multimodal vision โ Amazon-ready product listing |
|
15 |
| Confirm & publish AI-generated listing to seller catalog |
|
* = required argument
๐ฆ MCP Resources (3)
URI | Description |
| Personal financial vault: balances, categories, transactions |
| Household shared pool, member limits, pending splits |
| MCP server health, latency metrics, RPC audit trails |
๐ MCP Prompts (2)
Name | Description |
| Deep financial audit prompt with savings goal integration |
| Bilateral negotiation prompt for Buyer-Seller discount bridge |
๐งช Testing Guide for Judges
Quick JSON-RPC Test (curl)
# List all 15 tools
curl -X POST http://localhost:3000/mcp/v1/rpc \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
# Call validate_purchase_safety
curl -X POST http://localhost:3000/mcp/v1/rpc \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"validate_purchase_safety","arguments":{"itemName":"Bose Headphones 700","itemPrice":219.00,"category":"shopping"}}}'
# Read financial vault resource
curl -X POST http://localhost:3000/mcp/v1/rpc \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"resources/read","params":{"uri":"vault://financial/overview"}}'Web Simulator โ 7 Demo Scenarios
Launch index.html (or http://localhost:3000) and type these into the Alexa+ chat:
# | Type This | Tool Invoked | What to Observe |
1 |
|
| Buyer mode: personal standup (cashflow/bills/sniper radar) ยท Seller mode: store ops briefing (revenue/stockout/orders) |
2 |
|
| Multi-agent swarm warns of $450 upcoming obligations causing -$129 deficit |
3 |
|
| RMA ticket issued, prepaid return label, +$219 instant escrow credit |
4 |
|
| Bilateral negotiation issues voucher |
5 |
|
| Voice bill-split dispatched to Echo Dot of household members |
6 |
|
| FBA co-pilot flags 3.3-day stockout, drafts PO-SUPPLIER-77491 |
7 | Switch to Seller Mode โ |
| Role-aware: shows Apex Tech Store operations briefing, not Buyer data |
MCP Inspector Tab (Built-in)
Click "MCP Inspector" in the left sidebar
Select any of the 15 registered tools from the dropdown
Click "Execute JSON-RPC Tool"
Observe structured JSON response with sub-15ms latency indicator
Bilingual Test
Click the ID / US toggle in the top-right header to instantly switch all UI labels, voice synthesis accent, and agent reasoning trace language.
๐๏ธ Architecture

flowchart TD
A["๐ค Buyer / Seller"] -->|Voice + Touch| B["๐ Alexa+ Echo Show / Fire TV / Web Simulator"]
B -->|"Streamable HTTP / SSE"| C["๐ JSON-RPC 2.0\n/mcp/v1/rpc + /mcp/v1/sse"]
subgraph MCP ["โก VaultAlexa+ MCP Server โ Node.js / Express"]
C --> D["๐ง Role-Aware Intent Router\nprocessUserQuery()"]
D --> E["๐ Buyer Branch\n11 Tools"]
D --> F["๐ช Seller Branch\n4 Tools"]
E & F --> G["๐ ๏ธ 15 MCP Tools"]
E & F --> H["๐ฆ 3 Resources"]
E & F --> I["๐ 2 Prompts"]
end
G -->|"Agent Orchestration"| J["โ๏ธ AWS Bedrock AgentCore\nClaude 3.5 / Nova Pro"]
G -->|"Vision Analysis"| K["๐๏ธ Google Gemini 2.0 Flash\nMultimodal Product Vision"]
G -->|"Encrypted IAM"| L[("๐๏ธ DynamoDB\nPrimeVaultLedger")]
G -->|"SigV4 Auth"| M[("๐๏ธ Amazon SP API")]
G -.->|"Telemetry"| N["๐ CloudWatch"]Role-Aware Dual-Agent Flow
User Query
โ
โผ
processUserQuery()
โ
โโ[window.currentUserRole === 'seller']โโโบ Seller Intent Chain
โ โโโ generate_morning_briefing (Store Ops Briefing)
โ โโโ predict_inventory_stockout (FBA Co-Pilot)
โ โโโ analyze_product_image_listing (Multimodal Vision)
โ โโโ publish_seller_product (Human-in-the-Loop Confirm)
โ
โโ[window.currentUserRole === 'buyer']โโโโบ Buyer Intent Chain
โโโ validate_purchase_safety (Budget Guard)
โโโ predict_monthly_runway (Deficit Forecast)
โโโ negotiate_dynamic_discount (Bilateral Negotiation)
โโโ initiate_purchase_dispute (RMA & Refund)
โโโ generate_morning_briefing (Personal Finance Standup)๐ Project Structure
vault-alexa-mcp/
โโโ index.html # Web simulator UI (Single-Page App)
โโโ app.js # Frontend controller & agent intent router
โโโ styles.css # Premium glassmorphism UI design system
โโโ mcp-server.js # MCP Server (Express / JSON-RPC 2.0 / SSE)
โโโ mcp-config.json # MCP manifest (Spec 2025-11-25, Streamable HTTP)
โโโ package.json # npm config โ version 2.5.0
โโโ test-mcp.js # MCP JSON-RPC compliance test (9 methods)
โโโ test-dom-and-sync.js # DOM state sync test
โโโ test-e2e-dom.js # End-to-end role-switching E2E test
โโโ FRICTION_LOG.md # Hackathon bonus: developer friction feedback
โโโ LICENSE # MIT License
โโโ docs/
โโโ Naskah_Video_Demo_VaultAlexa.html
โโโ Panduan_Submisi_Hackathon_VaultAlexa.html๐งช Running the Full Test Suite
# MCP Protocol Compliance (9 JSON-RPC methods verified)
npm test
# DOM Sync & State Consistency
npm run test:dom
# Full Suite
npm run test:allExpected output: โ
All 9 MCP JSON-RPC 2.0 Method Calls Verified Successfully! (15 Tools + 3 Resources + 2 Prompts registered on server)
โ๏ธ AWS Services
Service | Role in VaultAlexa+ |
Amazon API Gateway | TLS 1.3 ingress for Streamable HTTP / SSE |
AWS Lambda / ECS Fargate | Hosts stateless MCP server (sub-15ms) |
AWS Bedrock AgentCore | Multi-agent orchestration (Claude 3.5 / Nova Pro) |
Amazon DynamoDB | Encrypted personal financial vault ledger |
Amazon Selling Partner API | Live Prime catalog & seller fulfillment |
Amazon CloudWatch | RPC latency telemetry & audit trails |
๐ Hackathon Compliance Summary
Requirement | Status |
MCP Spec | โ |
Transport: Streamable HTTP + SSE | โ |
JSON-RPC 2.0 ( | โ |
Minimum 5 agentic tools | โ 15 tools |
Human-in-the-Loop safety guardrails | โ
|
Proactive agent (not just reactive) | โ
|
Developer Friction Log (Bonus 10%) | |
Open Source MIT License | โ |
Working demo / test scripts | โ
|
๐ค Author
KARYA LANGIT Digital โ Supriadi
Amazon Developer Hackathon 2026 ยท Alexa+ MCP Server Track
๐ง karyalangitdigital
๐ License
Distributed under the MIT License. See LICENSE for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
Related MCP Connectors
Get offers and rewards matched to what you buy on Amazon, with a single prompt to your AI assistant.
Shopping MCP for AI agents: search, compare, Amazon buy links. Auto-register.
Connects Amazon Seller Central and Amazon Advertising to any MCP client. Settlement-accurate P&L - every fee, refund and reimbursement as Amazon posted it - plus contribution margin and breakeven per product, per marketplace, per day. Full Sponsored Products, Brands and Display management: search terms, placements, keyword and competitor research, dayparting, automation rules. 110 tools: 78 read-only (P&L, PPC at every grain, SQP/Brand Analytics, inventory, forecasting), 28 staged writes (every change is a proposal you review and confirm before it reaches Amazon - there is no autonomous-write mode), and 4 confirmation & support tools. 4 additional AI Workforce tools appear once a client is connected.
AI-powered product search, affiliate links, and price negotiation for e-commerce platforms
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage personal finances through MCP tools for transaction management, spending analytics, and goal tracking.1-
- AlicenseNot gradedqualityCmaintenanceEnables Alexa+ agents to purchase x402-protected digital resources while a human retains control over budget, approval, and wallet signing via MCP tools.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Alexa+ to manage household admin tasks: checking upcoming bills, verifying funding, detecting anomalies, auto-handling routine payments, and escalating only when a human decision is required.1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceIt is an MCP server that bridges personal finance and Amazon commerce, letting buyers check purchases against budgets, surface deals, negotiate discounts, split household expenses, forecast deficit risk, and simulate opportunity cost. It also gives sellers FBA stockout prediction, repricing analysis, order monitoring, and AI-generated product listings from uploaded photos.MIT



