Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

Namaste America

✓ del servicio · namasteamerica.us

de manvigallc007-specversión 0.1.0i★ 0iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registrous.namasteamerica/namaste-america

Cómo instalar

Qué hace

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

Texto original del autor

  • Conexión Se ejecuta en la nube
  • Cuenta o clave No necesita clave
  • Categoría Viajes, mapas y clima

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso12/100

Calidad: Pasó 2/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 2/5 revisiones · Funciona en tu computadora

Ocultamos parte de los comandos

Conectar por URL: la dirección del servidor no respondió cuando la revisamos

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría · Instrucciones del autor · Otros de esta categoría

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Claude todavía no puede conectar Namaste America

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

ChatGPT todavía no puede conectar Namaste America

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

Lo que puedes hacer en su lugar

B · Otros en Viajes, mapas y clima que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Claude Code todavía no puede conectar Namaste America

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

Cursor todavía no puede conectar Namaste America

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

VS Code todavía no puede conectar Namaste America

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

Aún no hay una forma de instalar que haya pasado la revisión. Mira las instrucciones del autor o elige otro servidor de esta categoría

¿Te atascaste? Pregunta a quien usa Namaste America💬 Conversación →

De un vistazo

Descargas por semanai
No está en npm/PyPI
Dominio verificado
✓ namasteamerica.us
Licenciai
Sin licencia indicada
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.1.0
Publicado en el registroi
8 jul 2026
Último cambio de códigoi
16 nov 2026
Última revisión
16 nov 2026
Creador
manvigallc007-spec
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 16 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ! Precaución

    El creador coincide con el repo

    Quien lo publicó (namasteamerica.us) no es el dueño del repo (manvigallc007-spec); puede que otra persona lo haya listado

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 4 días

  • ✕ No superada

    Tiene licencia

    No se encontró ningún archivo de licencia en el repo

  • ✕ No superada

    El endpoint responde

    No respondió en 6 segundos cuando lo revisamos

  • – No aplica

    Inicio de sesión con OAuth

    No respondió en 6 segundos cuando lo revisamos

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 60 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Viajes, mapas y climai

  • Más estrellas que el 0% de los otros 2052 servidores de esta categoría
  • Publicado en el registro más recientemente que el 12% de los otros 2052 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 7% de los otros 2052 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Namaste America?

Superó 2 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 4 días, y la última versión (0.1.0) llegó al registro hace 4 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Mu

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

de microEn crecimiento★ 441Actualizado hace 4 meses

Se ejecuta en la nube✓ micro.mu

Killbottleneck

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

de tengolabsInicial↓ 328/sem★ 14Actualizado hace 13 días

Se ejecuta en tu computadora✓ del servicio · killbottleneck.com

Whimsical

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

de WhimsicalCodeInicial★ 11Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · whimsical.com
Comparado con otros parecidos
Este
Namaste America
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas2/54/43/33/34/44/4
Licencia–AGPL-3.0MITMITMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo