PROJECT 01

/Product & Infrastructure Platform/2025–Present

HamroLink

Building a Connected Operating System for Emerging Commerce

HamroLink bridges storefronts, inventory, payment verification, and autonomous AI agents through an integrated Model Context Protocol architecture.

LIVE SYSTEM

STATUS: In active development and merchant testing.

01/OVERVIEW

The Context & Motivation

In developing economies like Nepal, digital commerce is experiencing rapid adoption, but merchant tooling remains severely fragmented.

A typical store merchant uses Instagram or TikTok for lead generation, exchanges bank transfer screenshots over Viber or WhatsApp, manually checks bank balances on their phone, writes orders in physical notebooks, and coordinates with independent delivery riders individually.

HamroLink is built from the ground up as a unified business operating system: giving merchants a headless storefront, real-time stock sync, localized digital payment gateways, and an autonomous AI agent capable of handling operational busywork.

02/THE PROBLEM

The Disconnected Stack Dilemma

When software tools don't communicate with each other, human beings become the glue between systems. In emerging markets, this results in significant revenue leakage and operational paralysis.

Manual Payment Verification

Merchants spend hours matching bank deposit screenshots with order numbers, causing shipment delays and fraud vulnerability.

Ghost Inventory

Selling across physical storefronts and social channels without unified synchronization creates constant stockouts and overselling.

Siloed Customer Data

Zero retention mechanisms; customer contact info is locked inside disparate social messaging apps with no lifetime value tracking.

High Tech Barrier

Western SaaS platforms like Shopify or Salesforce are priced in USD, lack native Nepali payment SDKs, and assume sophisticated technical overhead.

03/PRODUCT SOLUTION

An Integrated System, Not Isolated Tools

HamroLink replaces this disjointed stack with an interconnected platform designed specifically for the operational reality of local merchants.

Instant Storefront Engine

Lightweight, mobile-first web storefronts engineered to load in under 1.2 seconds even on spotty 3G/4G connections.

Direct Gateway Settlement

Native integration with eSewa, Khalti, and Fonepay QR, automating instant transaction verification and order tagging.

Living Catalog & State Ledger

A centralized data store where physical POS scans, online checkouts, and agent-processed requests update the same atomic inventory ledger.

Omnichannel Customer Memory

Consolidated purchase histories, preferences, and communication logs across all client touchpoints.

04/SYSTEM ARCHITECTURE

Architected for Isolation, Scale, and Reliability

The system is architected across three distinct layers: the Business Presentation & Operational Layer, the AI & Context Orchestration Layer, and the Multi-Tenant Infrastructure Layer.

Every merchant tenant operates within isolated database schemas using PostgreSQL row-level security (RLS), while sharing high-throughput distributed workers for webhook ingestion and asynchronous order processing.

HAMROLINK LIVING ARCHITECTURE

Interconnected Multi-Tier Architecture

MCP PROTOCOL·POSTGRES RLS

AI & AGENTIC LAYER SUBSYSTEMS & CONTRACTSLIVE SPEC

Business Copilot Agent

ORCHESTRATION

Autonomous agent operating over live tenant data with scoped permissions.

Structured Business Context

KNOWLEDGE

Real-time state assembly converting relational records into actionable prompt contexts.

Event-Driven Triggers

RUNNER

Deterministic background tasks executing recurring audits and customer triage.

Tool Calling Registry

EXECUTION

Strictly typed tool signatures allowing LLMs to mutate inventory, issue refunds, and adjust orders safely.

EVENT BUS: ASYNC REDIS·PROTOCOL: MCP JSON-RPC 2.0

VIEW FULL PROTOCOL CONTRACTS

05/AI & PROTOCOLS

AGENTIC RUNTIME

Autonomous Agents Powered by Business Context

Rather than a generic chatbot that provides canned replies, HamroLink's AI layer is an operational agent integrated directly into the merchant's business state.

When a customer asks 'Is the navy blue jacket in size L available in Kathmandu?', the agent queries the live inventory system, checks courier coverage for that postal area, and can generate a pre-filled checkout link within milliseconds.

Natural Language Querying: Merchants can ask 'What were my top 3 grossing items this week?' and receive instant aggregations.

Automated Customer Support: Handles first-touch inquiries on delivery times, return policies, and stock availability 24/7.

Low-Stock Forecasting: Monitors sales velocity and alerts merchants before high-demand items run out.

MCP CONTRACTS

Model Context Protocol (MCP) Integration

HamroLink implements the Model Context Protocol (MCP) as its foundational interface between LLMs and business databases. MCP provides a standardized, type-safe contract that prevents hallucinations and guarantees deterministic tool invocation.

Strict JSON Schema validation for all mutative operations (e.g., issue_refund, update_stock, cancel_order).

Scoped RBAC tokens ensuring AI agents can never read credentials or alter financial balances beyond established thresholds.

Complete audit trails logging every agent inference, tool call input, and database state mutation.

06/TECH STACK

The Engineering Foundation

Frontend & Interface

Next.js App Router
React 19
Tailwind CSS
Framer Motion
Lucide React
Radix UI Primitives

Backend & Services

Node.js
TypeScript
Prisma ORM
tRPC
WebSocket Events

AI & Protocol

Model Context Protocol (MCP)
Anthropic / OpenAI API
Vector Context Assembly
Structured Tool Calling

Database & Infrastructure

PostgreSQL
Supabase
Redis (Upstash)
Docker
Vercel Edge Network

07/TAKEAWAYS

Core Architectural Learnings

In emerging markets, software adoption fails when it requires users to change their behavior. The software must adapt to existing WhatsApp/cash habits rather than forcing Western enterprise workflows.

AI agents without deterministic tool boundaries are liabilities; MCP provides the exact guardrail framework required for commercial adoption.

Fast page load times (< 1.5s) directly correlate with checkout conversion when customers are on mobile networks with high packet loss.

08/ROADMAP

Active Exploration & Roadmap

Expanding native courier API integrations (Nepal Can Move, Pathao, CourierEx).

Offline-first POS Progressive Web App with indexedDB synchronization.

Multi-currency support for Nepali diaspora businesses selling overseas.

Fine-tuned localized language models for Nepali and Romanized Nepali customer interactions.

Distrya

EXPLORE DISTRYA