mcp server

Namaste America

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

Description as published by the maintainer. Source

• version 0.1.0
• active

active — Registry entry last updated 2026-07-08.

What this server can do

66 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

ask_community_question(city, question, vertical, member_email)

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'}. Required: question, member_email.

follow_city(city, member_email)

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'}. Required: member_email, city.

get_apparel_details(apparel_id)

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

get_community_answers(slug)

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'}. Required: slug.

get_community_details(community_id)

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

get_education_details(education_id)

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

get_event_details(event_id)

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

get_festival_dates(limit, query)

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

get_finance_details(finance_id)

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

get_grocery_details(grocery_id)

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

get_h1b_sponsor_details(sponsor_id)

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. Required: sponsor_id.

get_indian_apparel(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_community(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_education(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_events(lat, lng, tag, city, limit, state, offset, category, include_past, radius_miles)

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

get_indian_finance(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_groceries(lat, lng, tag, city, limit, state, offset, open_now, region_tag, radius_miles)

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

get_indian_legal(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_movies_in_theaters(limit, language)

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.

get_indian_professionals(lat, lng, tag, city, limit, state, offset, open_now, speciality, radius_miles, profession_type)

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.

get_indian_realestate(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_restaurants(lat, lng, tag, city, limit, state, offset, open_now, region_tag, dietary_tags, radius_miles, featured_only)

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.

get_indian_salons(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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.

get_indian_services(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_studios(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_sweets(lat, lng, tag, city, limit, state, offset, open_now, radius_miles)

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_indian_temples(lat, lng, tag, city, limit, state, offset, open_now, religion, denomination, radius_miles)

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

get_legal_details(legal_id)

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

get_movie_details(movie_id)

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. Required: movie_id.

get_offers(city, limit, state, vertical)

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

get_professional_details(professional_id)

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

get_realestate_details(realestate_id)

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

get_restaurant_details(restaurant_id)

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

get_reviews(limit, vertical, listing_id)

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}]}. Required: vertical, listing_id.

get_salon_details(salon_id)

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

get_service_details(service_id)

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

get_studio_details(studio_id)

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

get_sweets_details(sweets_id)

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

get_temple_details(temple_id)

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

get_today_highlights(city, state, languages)

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.

list_follows(member_email)

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

list_saved_places(limit, member_email)

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}]}. Required: member_email.

save_place(vertical, listing_id, member_email)

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'}. Required: member_email, vertical, listing_id.

search_all(lat, lng, city, limit, query, state, offset)

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`. Required: query.

search_apparel_by_text(city, limit, query, state, offset)

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

search_community_by_text(city, limit, query, state, offset)

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

search_community_questions(limit, query)

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}]}. Required: query.

search_education_by_text(city, limit, query, state, offset)

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

search_events_by_text(city, limit, query, state, offset)

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

search_finance_by_text(city, limit, query, state, offset)

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

search_groceries_by_text(city, limit, query, state, offset)

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

search_h1b_sponsors(limit, query, state)

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.

search_knowledge(limit, query, vertical)

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}]}. Required: query.

search_legal_by_text(city, limit, query, state, offset)

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

search_professionals_by_text(city, limit, query, state, offset)

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

search_realestate_by_text(city, limit, query, state, offset)

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

search_restaurants_by_text(city, limit, query, state, offset)

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). Required: query.

search_salons_by_text(city, limit, query, state, offset)

Free-text/semantic search over Indian beauty salons. Required: query.

search_services_by_text(city, limit, query, state, offset)

Free-text/semantic search over Indian community services. Required: query.

search_studios_by_text(city, limit, query, state, offset)

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

search_sweets_by_text(city, limit, query, state, offset)

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

search_temples_by_text(city, limit, query, state, offset)

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

submit_correction(field, value, reason, vertical, listing_id)

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}. Required: listing_id, field, value.

submit_listing(city, name, phone, state, website, vertical, address_full, contact_email)

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'}. Required: vertical, name.

submit_review(name, text, rating, vertical, listing_id)

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'}. Required: vertical, listing_id, rating.

unsave_place(vertical, listing_id, member_email)

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

Last successful function declaration observed on 2026-08-13. Source: https://namasteamerica.us/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://namasteamerica.us/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/manvigallc007-spec/indousmcp
• Website — https://namasteamerica.us/for-agents
• Remote endpoint (streamable-http) — https://namasteamerica.us/mcp