프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요 로그인

Namaste America

✓ 서비스 회사 · namasteamerica.us

제작자: manvigallc007-spec버전 0.1.0i★ 0i클라우드에서 실행공식 사이트 ↗
레지스트리 이름us.namasteamerica/namaste-america

설치 방법

할 수 있는 일

Agent-first directory for Indians from India in the USA — restaurants, temples, events & more.

제작자가 쓴 원문

  • 연결 방식 클라우드에서 실행
  • 계정 또는 키 키 필요 없음
  • 분류 여행, 지도 및 날씨

이 순위인 이유

목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다

인기0/80GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20
최신성12/1230일 안에 릴리스나 코드 변경이 있으면 만점
응답 중0/8마지막 점검 때 클라우드 엔드포인트가 응답
사용 점수12/100

품질: 기본 점검 2/5개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 2/5 통과 · 내 컴퓨터에서 실행돼요

명령 일부를 숨겼어요

주소로 연결: 확인할 때 서버 주소가 응답하지 않았어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요 · 만든 사람의 설치 안내 · 같은 분류의 다른 서버

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude는 아직 Namaste America에 연결할 수 없어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

ChatGPT는 아직 Namaste America에 연결할 수 없어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

대신 이렇게 할 수 있어요

B · 여행, 지도 및 날씨에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Claude Code는 아직 Namaste America에 연결할 수 없어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

Cursor는 아직 Namaste America에 연결할 수 없어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

VS Code는 아직 Namaste America에 연결할 수 없어요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

아직 확인을 통과한 설치 방법이 없어요. 만든 사람의 안내를 보거나 같은 분류의 다른 서버를 고르세요

막혔나요? Namaste America을 쓰는 사람에게 물어보세요💬 토론 →

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
확인된 도메인
✓ namasteamerica.us
라이선스i
라이선스 표시 없음
연결 방식
클라우드에서 실행
전송 방식
streamable-http
최신 버전i
0.1.0
레지스트리 공개i
2026년 7월 8일
코드 마지막 변경i
2026년 11월 16일
마지막 확인
2026년 11월 16일
제작자
manvigallc007-spec
웹사이트
namasteamerica.us
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

모든 앱과 장단점 →

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 16일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • get_indian_restaurants

    Find Indian restaurants by location and/or filters. Provide either a point (`lat`+`lng`, optionally `radius_miles`) or `city`/`state`. Optional filters: `region_tag` (e.g. "Gujarati", "South Indian"), `dietary_tags` (any of "vegetarian", "vegan", "halal", "jain"), `tag` (a keywor

  • get_indian_movies_in_theaters

    List Indian-language movies currently playing in US theaters (Hindi, Telugu, Tamil, Malayalam, Kannada, Punjabi, Bengali, Marathi, Gujarati). Optional `language` filters to one (e.g. "Telugu"). Each movie includes `title`, `language`, `poster_url`, `overview`, `release_date`, `ge

  • search_h1b_sponsors

    Search US employers that sponsor H-1B visas — the visa most Indians-from-India use to work in the USA. Filter by employer name (`query`) and/or worksite `state` (2-letter). Ranked by number of certified Labor Condition Applications. Each result has `certified` (count), `median_wa

  • get_restaurant_details

    Fetch the full canonical record for one restaurant, plus its version history.

  • search_restaurants_by_text

    Free-text search over restaurant name/cuisine/region, ranked by relevance. Optionally constrain to a `city`/`state`. Featured listings are surfaced first. Use `offset` to page further (the response's `has_more` says whether another page exists).

  • submit_correction

    Propose a correction to a listing field (agents/users reporting bad data). `vertical` is the category key (default 'restaurants'); `listing_id` is the id from that category's get_/search_ tools. Correctable restaurant fields: phone, email, website, menu_url, address_full, city, s

  • submit_review

    Submit a community review (1-5 star rating + optional text) for a listing. `vertical` is the category key (restaurants, temples, groceries, professionals, salons, apparel, sweets, studios, services, community, legal, education, realestate, finance) and `listing_id` is the id retu

  • get_reviews

    Published community reviews for a listing (newest first) + its rolled-up community rating. The community rating is first-party (visitor-submitted) and is separate from any web-harvested `rating` returned by the get_/search_ tools. Each review includes the business owner's public

  • get_indian_temples

    Find Indian-American temples (Hindu/Sikh/Jain places of worship). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `religion` ("hindu", "sikh", "jain"), `denomination` (e.g. "swaminarayan"), `tag`, or `open_now`. Records include description, dei

  • get_temple_details

    Full canonical record for one temple, plus its version history.

  • search_temples_by_text

    Free-text/semantic search over temples (name/deity/denomination/region).

  • get_indian_groceries

    Find Indian grocery stores (desi groceries / supermarkets). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Optional `region_tag` (e.g. "Gujarati"), `tag` (e.g. "spices", "halal"), `open_now`. Records include description, store type, tags, hours, region

  • get_grocery_details

    Full canonical record for one grocery store, plus its version history.

  • search_groceries_by_text

    Free-text/semantic search over Indian grocery stores (name/region/store type).

  • get_indian_professionals

    Find Indian-American healthcare professionals (doctors, dentists, clinics, pharmacies). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `profession_type` ("doctors", "dentist", "clinic", "pharmacy"), `speciality` (e.g. "pediatrics", "cardiology

  • get_professional_details

    Full canonical record for one professional/practice, plus its version history.

  • search_professionals_by_text

    Free-text/semantic search over Indian-American healthcare professionals.

  • get_indian_salons

    Find Indian beauty salons (threading, henna/mehndi, hair, bridal). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "threading", "henna", "bridal") or `open_now`. Records include description, services (tags), hours and an `open_now`

  • get_salon_details

    Full canonical record for one salon, plus its version history.

  • search_salons_by_text

    Free-text/semantic search over Indian beauty salons.

  • get_indian_events

    Find upcoming Indian-American community events (festivals, garba, concerts, puja). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `category` ("festival", "garba", "concert", "puja", …) or `tag` ("diwali", "holi", …). Returns UPCOMING events by

  • get_event_details

    Full canonical record for one event, plus its version history.

  • search_events_by_text

    Free-text/semantic search over Indian-American events (incl. past, for history). `offset` pages.

  • get_indian_apparel

    Find Indian apparel & jewelry stores (sarees, lehengas, ethnic wear, gold jewelers). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "saree", "bridal", "gold", "jewelry", "tailoring") or `open_now`.

  • get_apparel_details

    Full canonical record for one apparel/jewelry store, plus its version history.

  • search_apparel_by_text

    Free-text/semantic search over Indian apparel & jewelry stores.

  • get_indian_sweets

    Find Indian sweets shops (mithai) & bakeries. Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "mithai", "jalebi", "bakery", "eggless") or `open_now`.

  • get_sweets_details

    Full canonical record for one sweets shop / bakery, plus its version history.

  • search_sweets_by_text

    Free-text/semantic search over Indian sweets shops & bakeries.

  • get_indian_studios

    Find Indian yoga & cultural studios (yoga, classical dance, music, language classes). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "yoga", "bharatanatyam", "kathak", "tabla", "carnatic") or `open_now`.

  • get_studio_details

    Full canonical record for one studio, plus its version history.

  • search_studios_by_text

    Free-text/semantic search over Indian yoga/dance/music studios.

  • get_indian_services

    Find Indian community services (money transfer/remittance, banks, immigration/visa, travel agents, tax/insurance). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "money-transfer", "immigration", "travel", "tax") or `open_now`.

  • get_service_details

    Full canonical record for one service business, plus its version history.

  • search_services_by_text

    Free-text/semantic search over Indian community services.

  • get_indian_community

    Find Indian community organizations & cultural associations (regional samaj/sangam, cultural centers, Indo-American associations). Provide a point (`lat`+`lng`) or `city`/`state`. Filter by `tag` (e.g. a region like "telugu", "gujarati", or "association"/"cultural_center").

  • get_community_details

    Full canonical record for one community organization, plus its version history.

  • search_community_by_text

    Free-text/semantic search over Indian community organizations & associations.

  • get_indian_legal

    Find Indian-American immigration attorneys & law firms. Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "immigration").

  • get_legal_details

    Full canonical record for one immigration/legal listing, plus its version history.

  • search_legal_by_text

    Free-text/semantic search over Indian-American immigration attorneys & law firms.

  • get_indian_education

    Find Indian-American education & tutoring (heritage/language schools, Bal Vihar, coaching). Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "language_school", "heritage", "tutoring").

  • get_education_details

    Full canonical record for one education/tutoring listing, plus its version history.

  • search_education_by_text

    Free-text/semantic search over Indian-American education & tutoring.

  • get_indian_realestate

    Find Indian-American realtors & real-estate agencies. Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "agency", "mortgage").

  • get_realestate_details

    Full canonical record for one real-estate listing, plus its version history.

  • search_realestate_by_text

    Free-text/semantic search over Indian-American realtors & real-estate agencies.

  • get_indian_finance

    Find Indian-American CPAs, tax preparers & financial advisors. Provide a point (`lat`+`lng`, optional `radius_miles`) or `city`/`state`. Filter by `tag` (e.g. "cpa", "tax", "financial_advisor").

  • get_finance_details

    Full canonical record for one finance/tax listing, plus its version history.

  • search_finance_by_text

    Free-text/semantic search over Indian-American CPAs, tax preparers & financial advisors.

  • search_all

    Search across ALL Indian-American verticals at once — restaurants, temples, groceries, healthcare professionals, beauty salons, events, apparel & jewelry, sweets & bakeries, yoga/dance studios, and community services. Use for broad queries like "Indian things near me in Edison NJ

  • get_festival_dates

    Upcoming Indian & South-Asian festival dates for planning in the USA. With no `query`, returns the next `limit` festivals soonest-first. With a `query` (e.g. "Diwali", "when is holi"), returns the single soonest matching festival. Each item has name, date (ISO), days_until, emoji

  • search_knowledge

    Grounded answers from the Namaste America knowledge base — culture, festivals, visa/H-1B, tax, banking, and newcomer/settling-in guides for Indians from India living in the USA. Returns the top matching passages, each with the source document's title + url so you can cite it. Opt

  • submit_listing

    Submit a new Indian-American business/listing for REVIEW — it does NOT go live automatically. `vertical` is the category key (restaurants, temples, groceries, professionals, salons, apparel, sweets, studios, services, community, legal, education, realestate, finance — not events,

  • get_movie_details

    Full details for one Indian movie (the id from get_indian_movies_in_theaters). Returns the movie record (title, language, overview, release_date, genres, poster_url, ...) or {'error': 'not_found'}. Movie data from TMDB; this product uses the TMDB API but is not endorsed or certif

  • get_h1b_sponsor_details

    Full details for one H-1B sponsor (the id from search_h1b_sponsors). Returns the sponsor record (employer, certified counts, wages, top titles/states/cities, ...) or {'error': 'not_found'}. Aggregated from U.S. Department of Labor LCA disclosure data.

  • search_community_questions

    Search the Namaste America community Q&A — real questions Indians in the USA ask and answer ("Telugu-speaking pediatrician in Plano?", "best sweets for Diwali in Edison?"). Returns published questions matching the query, most-answered first, each with a `slug` you can pass to get

  • get_community_answers

    A community question + its published answers (Dost's AI answer first, then community answers by upvotes). `slug` comes from search_community_questions. Returns the question with an `answers` list, or {'error': 'not_found'}.

  • get_today_highlights

    What's happening in Indian America today, optionally for a city + languages — the upcoming festival (+ approximate tithi), soonest events nearby, Indian movies in theaters, places newly added in the city, a culture/immigration nugget, and trending community questions. `languages`

  • get_offers

    Live offers & announcements posted by Indian-American business owners (e.g. "20% off thalis this week", "new weekend Garba class"), optionally filtered by city/state/vertical. Returns current, non-expired owner posts with the listing they belong to. Great for "any deals near me t

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 20일 점검

  • ! 주의

    제작자와 저장소 일치

    게시자(namasteamerica.us)가 저장소 소유자(manvigallc007-spec)가 아니에요. 다른 사람이 등록했을 수 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 4일 전

  • ✕ 실패

    라이선스 있음

    저장소에서 라이선스 파일을 찾지 못했어요

  • ✕ 실패

    엔드포인트 응답

    점검할 때 6초 안에 응답하지 않았어요

  • – 해당 없음

    OAuth로 로그인

    점검할 때 6초 안에 응답하지 않았어요

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 60개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/us-namasteamerica-namaste-america.svg)](https://mcp.popnx.com/en/servers/us-namasteamerica-namaste-america)

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

여행, 지도 및 날씨 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 2052개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 2052개 중 12%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 2052개 중 7%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Namaste America, 안전한가요?

해당하는 기본 점검 5개 중 2개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 4일 전 변경됐고, 최신 버전(0.1.0)은 4개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

제작자: micro성장 중★ 4414개월 전 업데이트

클라우드에서 실행✓ micro.mu

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

제작자: tengolabs초기↓ 328/주★ 1413일 전 업데이트

내 컴퓨터에서 실행✓ 서비스 회사 · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

제작자: WhimsicalCode초기★ 112개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · whimsical.com
비슷한 항목과 비교
이 항목
Namaste America
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
실행 위치클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요컴퓨터에 설치 필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요
키 필요아니요아니요아니요예아니요아니요
Claude에서 +로 추가아니요아니요아니요아니요아니요예
기본 점검2/54/43/33/34/44/4
라이선스–AGPL-3.0MITMITMITMIT
가격등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

Indian–American Diaspora MCP Server

Agent-first, agent-only data layer for the Indian-American diaspora. Phase 1: Indian restaurants (USA). This repo is the walking skeleton from the architecture blueprint:

  • MCP server exposing restaurant capabilities (get_indian_restaurants, get_restaurant_details, search_restaurants_by_text, find_unclaimed_restaurants, draft_claim_outreach, submit_correction), temple capabilities (get_indian_temples, get_temple_details, search_temples_by_text) and grocery capabilities (get_indian_groceries, get_grocery_details, search_groceries_by_text) professional capabilities (get_indian_professionals, …), salon capabilities (get_indian_salons, …), and a cross-vertical `search_all` that searches every vertical at once (each result tagged with its vertical).
  • Data pipeline: scrape → raw → clean/enrich/score → approval queue → canonical table → versioning.
  • One real scraper: OpenStreetMap Overpass (public, ODbL-licensed, no login, ToS-safe).
  • Storage: PostgreSQL (+ pgvector for future embedding search) via Docker Compose.

Connect (live MCP server)

The hosted server is remote (no install) over streamable‑HTTP:

  • Endpoint: https://namasteamerica.us/mcp (transport: streamable-http, auth: none, read‑only)
  • Descriptor: https://namasteamerica.us/.well-known/mcp.json · Docs: https://namasteamerica.us/for-agents
{ "mcpServers": { "namaste-america": { "type": "streamable-http", "url": "https://namasteamerica.us/mcp" } } }

Tools (per vertical: restaurants, temples, groceries, professionals, salons, events, apparel, sweets, studios, services, community, legal, education, real estate, finance): get_indian_ , search_ _by_text, get_ _details, and a cross‑vertical `search_all`. Each result is JSON with address, geo, hours, contact, ratings, and languages.

Publishing to the official MCP registry: the manifest is server.json (namespace

us.namasteamerica, verified via DNS). Install the CLI (mcp-publisher), authenticate the domain

(mcp-publisher login dns --domain namasteamerica.us, then add the TXT record it prints), and run

mcp-publisher publish.

Architecture (Phase 1)

 OSM Overpass ──▶ restaurant_raw ──▶ clean()+score() ──▶ approval_queue ──▶ restaurants

(scraper) (JSONB) (pipeline) (high-risk only) (canonical) │ ▼ restaurant_versions │ ▼ MCP tools (FastMCP)

Low-risk new inserts are auto-applied (configurable); updates to claimed/featured listings are routed to the human approval queue.

Quick start

Requires Docker Desktop and Python 3.11+.

# 1. Start Postgres (with pgvector)

docker compose up -d

2. Create a virtualenv and install

python -m venv .venv .\.venv\Scripts\Activate.ps1 pip install -e .

3. Configure env

copy .env.example .env # default DATABASE_URL already points at the docker container

4. Initialise the schema

python -m indo_usa_mcp.cli init-db

5. Scrape one metro from OpenStreetMap, then process raw -> canonical

python -m indo_usa_mcp.cli scrape --metro bay_area python -m indo_usa_mcp.cli process

6. Inspect

python -m indo_usa_mcp.cli stats

7. Run the MCP server (stdio transport)

python -m indo_usa_mcp.server

CLI

CommandPurpose
init-dbApply SQL migrations (extensions, tables, indexes).
scrape --metro Run the OSM scraper for a metro bbox into restaurant_raw.
processClean/score unprocessed raw rows; auto-apply low-risk, queue high-risk.
approvalsList pending approval-queue items.
approve / reject Resolve an approval item.
outreach [--limit N]Draft claim outreach for unclaimed restaurants (creates claim links + messages).
verify-claim Owner-side: verify a claim token and take ownership.
agentsList the registered autonomous agents.
agent Run one agent now (audited in agent_runs).
agents-loop [--once]Run the scheduler (worker loop over due agents).
query [--city/--text/--lat --lng/--id/...]Call the MCP tool functions from the terminal.
seedLoad fictional seed restaurants for local testing (no scrape needed).
enrichBackfill region/dietary cultural tags on under-tagged restaurants.
deactivate-stale [--days 60]Mark unclaimed listings not seen recently as inactive.
approval-digestHuman-readable summary of the pending approval queue.
feedback --id N --field F --value VSubmit a field correction (applied by the feedback agent).
scrape --metro usaNationwide sweep (occasional; slower than a single metro).
`feature --id N [--days 30 \--permanent]`Mark a paid featured listing.
unfeature --id NRemove a featured listing.
backfill-embeddings [--all](Re)compute embeddings for canonical rows.
statsRow counts and coverage summary.

Monetization & delivery

  • Featured listings (feature/unfeature) — a paid tier; effectively-featured rows (flagged and within their featured_until window) surface first in every tool result.
  • Stripe checkout (optional) — claimed owners get a "Get Featured" button → Stripe Checkout → a signature-verified webhook (/stripe/webhook) auto-features them. Disabled until STRIPE_SECRET_KEY is set (then it's pay-per-sale, no monthly fee). See DEPLOY.md.
  • Outreach email delivery — optional and zero-cost: set Gmail SMTP + an app password in .env (see .env.example) and the Outreach Agent will auto-send claim emails to restaurants that have a public email; otherwise it stays draft-only.
  • Enrichment agent — strengthens the cultural "data moat" by inferring region/dietary tags from restaurant names (free, keyword-based).

Coverage spans 15 metros (Bay Area, NYC/NJ, Dallas, Houston, Chicago, LA, Seattle, Atlanta, Phoenix, Austin, Boston, Philadelphia, Raleigh, Detroit, Central NJ) plus an on-demand nationwide sweep (scrape --metro usa).

WhatsApp outreach is delivered as free click-to-send `wa.me` links (message pre-filled); true auto-send WhatsApp needs a paid API and is intentionally not used.

Trying it without a live scrape

python -m indo_usa_mcp.cli init-db

python -m indo_usa_mcp.cli seed # 12 fictional restaurants across the 5 metros python -m indo_usa_mcp.cli stats

Then exercise the MCP tools (e.g. get_indian_restaurants near the Bay Area, or search_restaurants_by_text "vegetarian dosa").

Search quality (for LLM agents)

Records are optimized for agent retrieval:

  • Natural-language `description` per record (e.g. *"Saffron House is a Gujarati Indian restaurant in Edison, NJ. Offers vegetarian, jain options. Price: $$."*) — generated from the structured fields, returned to agents, and used as the text that gets embedded.
  • Reverse-geocoded location — missing city/state are filled offline from coordinates (reverse_geocoder), so "near me / in " queries work for every record.
  • Keyword + attribute `tags` (e.g. biryani, dosa, halal, delivery, takeout, outdoor-seating, wheelchair-accessible, wifi, cards-accepted, organic) — derived from names and rich OSM attributes; agents filter with tag=..., and they boost embedding recall + appear in the description ("Amenities: …").
  • `open_now` — opening_hours are parsed into structured per-day intervals; each result carries an open_now flag (true/false/null) and the tools accept an open_now=true filter, enabling "what's open near me right now".
  • Dedup-merge — the admin Quality view lists duplicate groups with a one-click merge (fills the keeper's empty fields, soft-deletes the rest).

search_*_by_text ranks by embedding cosine distance (pgvector <=>), falling back to trigram. Providers (EMBEDDING_PROVIDER):

  • `hashing` (default) — feature-hashing, zero extra deps; lexical.
  • `fastembed` (recommended, prod default) — real semantic embeddings via BAAI/bge-small-en-v1.5 (384-dim, ONNX, no torch). The Docker image includes it and the prod compose defaults EMBEDDING_PROVIDER=fastembed; after deploying run python -m indo_usa_mcp.cli enhance-data once to re-embed existing rows. Set EMBEDDING_PROVIDER=hashing if the VPS is RAM-constrained.
  • `sentence_transformers` — all-MiniLM-L6-v2 (heavier, pulls torch).
  • `none` — trigram only.

enhance-data (re)generates descriptions, fills geocoding, and re-embeds existing rows — run it after enabling a new embedder. New records get all of this automatically on ingest.

Outreach & claiming (blueprint §7)

# Draft claim messages + single-use claim links for unclaimed restaurants

python -m indo_usa_mcp.cli outreach --limit 10

Later, an owner verifies their claim token (normally via the claim web page)

python -m indo_usa_mcp.cli verify-claim --email owner@example.com

After claiming, owners get an edit page (/manage?token=...) to update their phone, hours, menu, price, dietary tags, etc. — changes go live immediately and are protected from scraper overwrites (scraper updates to claimed listings route to the approval queue). Stale listings not re-seen for 60 days are auto-deactivated (is_active=false) and reactivated if they reappear in a later scrape.

The Outreach Agent finds unclaimed restaurants (skipping anything with an open claim or contacted within OUTREACH_COOLDOWN_DAYS), creates a single-use claim token + link, and drafts an honest, opt-out-friendly message per restaurant. Messages are not auto-sent — delivery needs channel integrations, and chains / featured / high-value targets are flagged requires_human. Once an owner verifies, restaurants.is_claimed flips to true and future scraper updates to that listing are routed to the approval queue. Agents can drive this via the find_unclaimed_restaurants and draft_claim_outreach MCP tools.

Autonomous agents (blueprint §6)

Each agent wraps a pipeline step, is idempotent, and writes a full audit row to agent_runs (errors captured, never half-written canonical data).

AgentDoes
discoveryReports metro coverage and proposes scrape targets.
scraperRuns every scraper across every metro into restaurant_raw.
cleanerProcesses raw → canonical via clean/score/approval.
outreachDrafts claim outreach for eligible unclaimed restaurants.
monitoringDetects anomalies (backlogs, scraper failures, stale data) → agent_alerts.
submissionSubmits the MCP to directories (manual stub for now).
python -m indo_usa_mcp.cli agents              # list agents

python -m indo_usa_mcp.cli agent scraper # run one, audited python -m indo_usa_mcp.cli agents-loop --once # one scheduler pass (scrape→clean→monitor…) python -m indo_usa_mcp.agents.scheduler # long-lived scheduler (VPS worker)

Data sources

Two independent public scrapers feed the pipeline: osm_overpass (OpenStreetMap, ODbL) and wikidata (Wikidata SPARQL, CC0). Pick one with scrape --source ; the Scraper Agent runs both.

Phase 2: Temples vertical

An independent vertical (Hindu/Sikh/Jain places of worship) sharing the same pipeline, agents, embeddings and deployment — per the blueprint's "independent verticals, shared

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요