Namaste America MCP Server

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`.

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").

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").

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 default (soonest first); set `include_past=true` for history. Each event has `start_at`/`end_at`, venue, category and a description. Use `offset` to page (the response's `has_more` says whether another page exists).

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").

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 and `open_now`.

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

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`, `genres`, and a `ticket_url` — a "find showtimes / buy tickets" search link (per-theater showtimes are not available via a free source). Data from TMDB.

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", "ayurveda"), `tag`, or `open_now`. Note: these are matched from public data via an Indian-name signal, so a `confidence_score` is included.

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").

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 keyword/dish like "biryani", "dosa", "catering"), `open_now` (only places open at the current time), `featured_only`. Use `offset` (e.g. offset=25 after a limit=25 page) to page further; the response's `has_more` says whether another page exists. Each record includes a `description`, `tags`, a `confidence_score` (0-1), an `is_featured` flag, an `open_now` flag (true/false/null), and `distance_miles` when a point was supplied.

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` flag.

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`.

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`.

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`.

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, deity, region, tags, hours and `open_now`.

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'}.

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

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

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_community_answers. A grounded, community-sourced complement to the listings + knowledge base. Returns {'count', 'results': [{slug, title, city, state, vertical, answer_count}]}.

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, state, region_tag, price_range, cuisine_type, festival_specials. The correction is stored and applied by the Feedback agent — automatically for unclaimed listings, or routed to a human for claimed/featured ones. Identity fields (name, coordinates) are not correctable. Structured field corrections currently apply to restaurants; for other categories use submit_review to flag issues (or the owner portal). Returns {ok, feedback_id|error}.

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, which are agent-managed). The submission enters a human moderation queue and is published only after an admin approves it. `name` is required; provide as much else as you can. Returns {'ok', 'id'} or {'ok': False, 'error': 'bad_vertical'|'name_required'}.

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 returned by that category's get_/search_ tools. Reviews are moderated: clean ones publish immediately and spam/abusive ones are held for human review. Returns {'ok', 'id', 'status'}.

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

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

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

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

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

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

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 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_wage`, `top_titles`, `top_states`, `top_cities`. Aggregated public figures from U.S. DOL disclosure data.

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

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

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

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

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

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

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" or "vegetarian South Indian". Results are ranked by relevance: an exact name match ranks first, then by keyword/semantic similarity, proximity (pass `lat`+`lng`) and freshness. Each result is tagged with its `vertical`. Optionally constrain by `city`/`state`.

Ask the Namaste America community a question on behalf of a signed-in member. `member_email` must be the authenticated member's email (not free text) — it attributes the question and guards against spam. Questions are moderated: clean ones publish immediately, others are held for review. Returns {'ok', 'id', 'slug', 'status'} or {'ok': False, 'error'}.

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

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

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 and a greeting. IMPORTANT: many Hindu/Sikh/Jain/Muslim festivals follow lunar calendars, so these dates are best-effort — always tell the user to confirm the exact date with their local temple, gurdwara, mosque or a panchang. Returns {'results': [...], 'note': ...}.

Follow a city so the member is notified of new events there (e.g. "Plano, TX"). `member_email` must be the authenticated member's email. Returns {'ok'} or {'ok': False, 'error'}.

What a member follows (cities + categories). `member_email` must be the authenticated member's email. Returns {'count', 'results': [{kind, value}]}.

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

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

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. Optionally scope to a `vertical`. Use this for factual "how/what/when" questions rather than the listing-search tools. Returns {'count', 'results': [{text, title, url, source_type, vertical}]}.

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 certified by TMDB.

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 this week". Returns {'count', 'results': [{title, body, kind, vertical, listing_id, name, city, state, created_at, expires_at}]}.

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

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

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

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).

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 reply when they've responded. Returns {'community_rating', 'community_rating_count', 'reviews': [{rating, title, body, author, created_at, owner_reply, owner_reply_at}]}.

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

Free-text/semantic search over Indian beauty salons.

Save a listing to a signed-in member's list. `member_email` must be the authenticated member's email. `vertical` + `listing_id` come from the get_/search_ tools. Returns {'ok', 'name'} or {'ok': False, 'error'}.

A member's saved places (each joined to its live listing). `member_email` must be the authenticated member's email. Returns {'count', 'results': [{vertical, id, name, city, state}]}.

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

Free-text/semantic search over Indian community services.

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

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

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

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

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` is a comma-separated list (e.g. "Telugu,Hindi"). Great for a daily briefing. Returns the assembled feed; date fields are ISO. Lunar festival/tithi dates are approximate — tell users to confirm locally.

Remove a listing from a member's saved list. `member_email` must be the authenticated member's email. Returns {'ok': True}.