Shopfront Chennai Local Commerce

Name: Shopfront Chennai Local Commerce
Author: jeeva-m-21

by jeeva-m-21version 2.0.0i★ –iRuns in the cloud

Registry nameio.github.jeeva-m-21/shopfront

Install

Overview

Description from the maker (original English)

Hyperlocal commerce and verified merchant directory MCP server for Chennai, India.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Online shops & payments

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
The registry lists no key to fill in.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://shopfront-rouge.vercel.app/mcp

Run this in your terminal

claude mcp add --transport http shopfront https://shopfront-rouge.vercel.app/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "shopfront": {
      "url": "https://shopfront-rouge.vercel.app/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "shopfront": {
      "type": "http",
      "url": "https://shopfront-rouge.vercel.app/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://shopfront-rouge.vercel.app/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account jeeva-m-21, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Online shops & paymentsi

More stars than 0% of the other 2533 servers in this category
Published to the registry more recently than 60% of the other 2533 servers in this category
Basic checks equal to or better than 100% of the other 2533 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Shopfront Chennai Local Commerce safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.0.0) reached the registry 20 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spree Commerce: open-source B2B and marketplace ecommerce

by spree

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

Runs in the cloud★ 15,812BSD-3-ClauseUpdated 8 days ago

Install

Stripe MCP

by stripe

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

Runs in the cloud★ 2,043MITUpdated 12 months ago

Install

MCP Cn Commerce

by TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

Runs on your computer★ 96MITUpdated 28 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🏪 Shopfront: Local Shops, Found by AI

“Be the answer when people ask AI.”

*Shopfront makes local businesses visible to AI assistants through the open Model Context Protocol (MCP).*

⚡ Quick Links & Live Demos

Resource	Direct Link	Description
🌐 Live Web Application	shopfront-rouge.vercel.app	Real-time discovery portal with verified Chennai merchant ledgers.
🤖 AI Agent Connect Portal	shopfront-rouge.vercel.app/connect	60-second MCP setup for Claude Desktop, Cursor, and custom agent sidecars.
🎨 Brand & Vector Assets	shopfront-rouge.vercel.app/brand	Official Stitch multi-view SVG logo system, typography, and color tokens.
📖 Technical Architecture Case Study	`TECHNICAL_CASE_STUDY.md`	Exhaustive problem-to-solution system design, PostGIS spatial indexing, and security architecture.
🔌 Streamable HTTP MCP Endpoint	`POST https://shopfront-rouge.vercel.app/api/mcp`	RFC-compliant Model Context Protocol streamable transport for agents.

📋 Table of Contents

The Core Novelty & Positioning
The Breakdown of Urban Apps vs. The AI Shift
The Solution: Three Key Differentiators
Deep Customization: You Decide What AI Says
System Architecture & Request Lifecycle
Live Endpoints & Model Context Protocol (MCP) Tools
Connect to AI Assistants (Claude, Cursor, ChatGPT)
Design System: "The Shutter Goes Up"
Scientific Offline Evaluation & Benchmarks
Local Development & Test Gates

1. The Core Novelty & Positioning

One line: Shopfront makes local businesses visible to AI assistants.

Tagline: *“Be the answer when people ask AI.”*

Short form: *“Local shops, found by AI.”*

┌────────────────────────────────────────────────────────────────────────┐

│ CUSTOMER ASKS AI: │ │ "Where can I get my iPhone battery replaced in Adyar right now under │ │ ₹2,000?" │ ├────────────────────────────────────────────────────────────────────────┤ │ WITHOUT SHOPFRONT: │ │ ❌ "I don't have real-time access to local shops or current prices. │ │ You may want to check Google Maps or call nearby stores." │ ├────────────────────────────────────────────────────────────────────────┤ │ WITH SHOPFRONT (MCP): │ │ ✅ "I found A1 Electronics in Adyar (450m away). They are open right │ │ now (verified 9m ago). Their iPhone Battery Replacement is │ │ ₹1,800. Click here to chat with the owner on WhatsApp: wa.me/..." │ └────────────────────────────────────────────────────────────────────────┘

Shopfront bridges the gap between physical urban retail and conversational intelligence. By turning neighborhood shops into queryable, authenticated nodes on the Model Context Protocol (MCP), merchants gain direct customer inquiries without building custom mobile apps or forfeiting 30% aggregator commissions.

2. The Breakdown of Urban Apps vs. The AI Shift

Urban commerce is experiencing a structural paradigm shift driven by consumer app fatigue and conversational AI:

flowchart TD

subgraph TheAppTrap["The Separate Franchise App & Marketplace Trap"] A1["Separate App per Franchise (McDonald's app, Domino's app, Swiggy, Zomato, Urban Company)"] A2["Severe App Fatigue (Users delete single-use apps; refuse to install 30 separate apps)"] A3["20% to 30% Aggregator Commissions (High take-rates erode independent merchant margins)"] A4["Walled-Garden Data Silos (Customer phone numbers masked; zero direct relationship)"] A1 --> A2 --> A3 --> A4 end

subgraph TheAIShift["The Conversational AI Revolution"] B1["Users Ask AI Instead of Opening Apps ('Find me a MacBook technician near Adyar')"] B2["AI Assistants Get ZERO Data (LLMs cannot read fragmented closed apps)"] B3["Result: Hallucinated defunct numbers or dead ends"] B1 --> B2 --> B3 end

TheAppTrap -.->|Broken Paradigm| Solution["Shopfront: The Authoritative Live Layer"] TheAIShift -.->|Needs Ground Truth| Solution

The Three Critical Industry Breakdown Points:

App Fatigue: Customers do not want to download, register, and update 30 different mobile apps for every local bakery, barber, and motorcycle garage.
The Aggregator Tax: Conventional aggregators extract 20% to 30% of gross transaction volume and mask customer identities, preventing merchants from building long-term loyalty.
The AI Search Blind Spot: When consumers ask Claude, Cursor, or ChatGPT for local recommendations, LLMs hallucinate or return generic blog scrapes because brick-and-mortar stores have no standard API or protocol representation.

3. The Solution: Three Key Differentiators

Shopfront replaces the fragmented app nightmare with a unified, protocol-driven architecture:

Differentiator	Traditional Aggregators & Franchise Apps	Shopfront (MCP Engine)
1. AI-Native Protocol	❌ Walled gardens; closed to AI assistants; invisible to conversational search.	✅ Native Model Context Protocol (MCP) server readable by Claude, Cursor, ChatGPT, and custom agent sidecars.
2. One Listing vs. 20 Apps	❌ Merchants spend ₹1,50,000+ building custom apps that users immediately uninstall.	✅ One low-cost, commission-free listing that automatically syndicates across all AI assistants.
3. Owner-Controlled Direct Contact	❌ Masked phone numbers; platform lock-in; delayed weekly payouts.	✅ Direct WhatsApp & telephone connection with pre-filled enquiry templates. Merchants keep 100% of revenue.

4. Deep Customization: You Decide What AI Says

Shopfront provides local merchants with absolute sovereignty over their data. Through the mobile-first Owner Portal, owners decide exactly what AI assistants know and recommend:

mindmap

root((Owner Customization)) Hours & Shift Breaks Real-time IST schedule Afternoon lunch breaks Temple & festival closures Exact Rupee Pricing Fixed menu prices Transparent price ranges Warranty terms Live Availability 1-thumb out-of-stock switches Capacity limits Service Area & Coordinates Millimeter PostGIS location Locality bounding polygon Craftsmanship & Story 20+ years experience Specialist certifications WhatsApp Opening Template Pre-filled item context Direct wa.me deep links Bilingual Localization Tamil keywords ஷாப்ஃபிரண்ட் English terminology

The 8 Signature Customization Levers:

1. Operating Shifts & Lunch Breaks: Configure discrete shift intervals (e.g. 09:00–13:00 and 16:30–21:30) and upcoming holiday dates. AI never sends customers to a closed shutter.
2. Exact Rupee Pricing: List precise prices (e.g. *iPhone Battery: ₹1,800*) to qualify high-intent customers and eliminate haggling.
3. Instant Availability Toggle: Flip an item unavailable with a single thumb-tap from your phone when parts run out. AI updates immediately.
4. Spatial Service Area: Pinpoint exact physical coordinates and service radiuses in PostGIS (SRID 4326).
5. Authentic Brand Story: Provide background on your techniques, heritage, and quality guarantees for AI to champion.
6. Pre-Formatted WhatsApp Message: Customize the greeting message generated when customers click your action link.
7. Bilingual Tamil & English Support: Enable native Tamil script matching alongside standard English.
8. Persistent "AI Preview": A live dashboard card in the Owner Portal showing the exact conversational response and raw MCP JSON that AI assistants receive.

5. System Architecture & Request Lifecycle

Shopfront combines sub-25ms PostGIS SQL retrieval with an LLM semantic decision reranker and a fail-open circuit breaker.

flowchart TB

subgraph Ingress["1. Ingress Layer"] User["🌐 Customer Browser Next.js 15 App"] Agent["🤖 AI Agent (Claude Desktop) Streamable HTTP / Stdio"] Merchant["📱 Shop Owner Mobile Web Portal"] end

subgraph SecurityLayer["2. Gateway Security & Auth"] RateLimit["⏱️ Sliding Window Rate Limiter (60 req/min)"] CSRF["🛡️ CSRF & Origin Guard (Sec-Fetch-Site Check)"] Argon["🔐 Argon2id (m=64MB, t=3, p=1) SHA-256 Session Token Hash"] end

subgraph SearchPipeline["3. Two-Stage Retrieval Pipeline"] Stage1["⚡ Stage 1: PostGIS Fast SQL • Spatial Radius & Bounding Box (H1) • Live Status & Admin Lock Checks (H2) • IST Temporal Shift Matching (H6) • Statement Timeout: 250ms"]

Sanitizer["🧹 Prompt Injection Stripper • Strip ASCII Control Chars • Exclude GPS coords, prices, hours"]

Stage2["🧠 Stage 2: Jev Decisions LLM Reranker • Parallel Candidate Scoring • Expected Score E[score] Formulation • Strict Time Budget: min(timeout, rem-30ms)"]

FailOpen["⚡ Fail-Open Circuit Breaker (On timeout/fault -> Fallback to Stage 1)"] end

subgraph Storage["4. Authoritative Database (PostgreSQL 16 + PostGIS 3.4)"] PGPool["🐘 Dedicated Connection Pool (Zero ORM)"] Shops[("shops & localities Spatial GIST Index")] Catalog[("catalog_items Available Offerings")] Shifts[("operating_shifts IST Intervals")] end

User --> RateLimit --> Stage1 Agent --> RateLimit --> Stage1 Merchant --> CSRF --> Argon --> PGPool

Stage1 --> PGPoo

Only the beginning is shown; read the rest in the repo

Shopfront Chennai Local Commerce

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Online shops & paymentsi

Common questions

Alternatives

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

README from the maker

🏪 Shopfront: Local Shops, Found by AI

⚡ Quick Links & Live Demos

📋 Table of Contents

1. The Core Novelty & Positioning

2. The Breakdown of Urban Apps vs. The AI Shift

The Three Critical Industry Breakdown Points:

3. The Solution: Three Key Differentiators

4. Deep Customization: You Decide What AI Says

The 8 Signature Customization Levers:

5. System Architecture & Request Lifecycle