Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Namaste America

✓ vom Dienst · namasteamerica.us

von manvigallc007-specVersion 0.1.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryus.namasteamerica/namaste-america

So installierst du es

Was es kann

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

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 2/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/5 Prüfungen bestanden · Läuft auf deinem Computer

Wir haben einen Teil der Befehle ausgeblendet

Per URL verbinden: die Server-Adresse hat bei der Prüfung nicht geantwortet

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie · Anleitung des Autors · Andere in dieser Kategorie

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Claude kann Namaste America noch nicht verbinden

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

ChatGPT kann Namaste America noch nicht verbinden

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

Das kannst du stattdessen tun

B · Andere in Reisen, Karten & Wetter, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Claude Code kann Namaste America noch nicht verbinden

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

Cursor kann Namaste America noch nicht verbinden

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

VS Code kann Namaste America noch nicht verbinden

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

Noch kein Installationsweg hat die Prüfung bestanden. Sieh dir die Anleitung des Autors an oder wähle einen anderen Server dieser Kategorie

Hängst du fest? Frag Leute, die Namaste America nutzen💬 Diskussion →

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ namasteamerica.us
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
0.1.0
In der Registry veröffentlichti
8. Juli 2026
Code zuletzt geänderti
16. Nov. 2026
Zuletzt geprüft
16. Nov. 2026
Entwickler
manvigallc007-spec
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 16. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (namasteamerica.us) ist nicht der Repo-Inhaber (manvigallc007-spec); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 4 Tagen

  • ✕ Nicht bestanden

    Hat eine Lizenz

    Keine Lizenzdatei im Repo gefunden

  • ✕ Nicht bestanden

    Endpunkt antwortet

    Hat bei unserer Prüfung nicht innerhalb von 6 Sekunden geantwortet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Hat bei unserer Prüfung nicht innerhalb von 6 Sekunden geantwortet

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 60 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 0 % der anderen 2032 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 12 % der anderen 2032 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 7 % der anderen 2032 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Namaste America sicher?

Er hat 2 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 4 Tagen geändert, und die neueste Version (0.1.0) kam vor 4 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

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

von microWachsend★ 441Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 15Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

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

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 13 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

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

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
Namaste America
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen2/54/43/33/34/44/4
Lizenz–AGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo