Namaste America

Official66 toolsLive

by manvigallc007-spec · Python

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

Indian–American Diaspora MCP Server (us.namasteamerica/namaste-america)

The MCP server is an agent-first, agent-only directory data layer for the Indian-American diaspora. It provides capabilities for Indian restaurants in the USA (Phase 1), plus temple and grocery access. The server is intended to support discovery, details lookup, search, and correction/claim workflows.

🛠️ Key Features

Exposes restaurant tools: get_indian_restaurants, get_restaurant_details, search_restaurants_by_text, find_unclaimed_restaurants, draft_claim_outreach, submit_correction
Exposes temple tools: get_indian_temples, get_temple_details, search_temples_by_text
Exposes grocery tools: get_indian_groceries, get_grocery_detail
Listed tool count: 66

🚀 Use Cases

Finding Indian restaurants in the USA
Looking up restaurant, temple, and grocery details
Text-based search for restaurants and temples
Handling unclaimed restaurant records and submitting corrections
Supporting temple and grocery discovery for the Indian-American diaspora

⚡ Developer Benefits

Agent-first integration via MCP tools
Structured access to restaurant, temple, and grocery data
Includes explicit support for search and entity detail retrieval

⚠️ Limitations

Phase 1 focuses on Indian restaurants in the USA; other domains are included but not described beyond available tools.

Captured live from the server via tools/list.

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

Parameters12

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
region_tag	any	optional
dietary_tags	any	optional
tag	any	optional
open_now	boolean	optional
featured_only	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 10,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "region_tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Region Tag"
    },
    "dietary_tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Dietary Tags"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "featured_only": {
      "default": false,
      "title": "Featured Only",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_restaurantsArguments"
}

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

Parameters2

language	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Language"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_indian_movies_in_theatersArguments"
}

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

Parameters3

query	any	optional
state	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "search_h1b_sponsorsArguments"
}

get_restaurant_details

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

Parameters1

restaurant_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "restaurant_id": {
      "title": "Restaurant Id",
      "type": "integer"
    }
  },
  "required": [
    "restaurant_id"
  ],
  "title": "get_restaurant_detailsArguments"
}

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_restaurants_by_textArguments"
}

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

Parameters5

listing_id	integer	required
field	string	required
value	string	required
reason	string	optional
vertical	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "listing_id": {
      "title": "Listing Id",
      "type": "integer"
    },
    "field": {
      "title": "Field",
      "type": "string"
    },
    "value": {
      "title": "Value",
      "type": "string"
    },
    "reason": {
      "default": "",
      "title": "Reason",
      "type": "string"
    },
    "vertical": {
      "default": "restaurants",
      "title": "Vertical",
      "type": "string"
    }
  },
  "required": [
    "listing_id",
    "field",
    "value"
  ],
  "title": "submit_correctionArguments"
}

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

Parameters5

vertical	string	required
listing_id	integer	required
rating	integer	required
text	string	optional
name	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "vertical": {
      "title": "Vertical",
      "type": "string"
    },
    "listing_id": {
      "title": "Listing Id",
      "type": "integer"
    },
    "rating": {
      "title": "Rating",
      "type": "integer"
    },
    "text": {
      "default": "",
      "title": "Text",
      "type": "string"
    },
    "name": {
      "default": "",
      "title": "Name",
      "type": "string"
    }
  },
  "required": [
    "vertical",
    "listing_id",
    "rating"
  ],
  "title": "submit_reviewArguments"
}

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

Parameters3

vertical	string	required
listing_id	integer	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "vertical": {
      "title": "Vertical",
      "type": "string"
    },
    "listing_id": {
      "title": "Listing Id",
      "type": "integer"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "vertical",
    "listing_id"
  ],
  "title": "get_reviewsArguments"
}

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

Parameters11

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
religion	any	optional
denomination	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "religion": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Religion"
    },
    "denomination": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Denomination"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_templesArguments"
}

get_temple_details

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

Parameters1

temple_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "temple_id": {
      "title": "Temple Id",
      "type": "integer"
    }
  },
  "required": [
    "temple_id"
  ],
  "title": "get_temple_detailsArguments"
}

search_temples_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_temples_by_textArguments"
}

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

Parameters10

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
region_tag	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "region_tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Region Tag"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_groceriesArguments"
}

get_grocery_details

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

Parameters1

grocery_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "grocery_id": {
      "title": "Grocery Id",
      "type": "integer"
    }
  },
  "required": [
    "grocery_id"
  ],
  "title": "get_grocery_detailsArguments"
}

search_groceries_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_groceries_by_textArguments"
}

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

Parameters11

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
profession_type	any	optional
speciality	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "profession_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Profession Type"
    },
    "speciality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Speciality"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_professionalsArguments"
}

get_professional_details

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

Parameters1

professional_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "professional_id": {
      "title": "Professional Id",
      "type": "integer"
    }
  },
  "required": [
    "professional_id"
  ],
  "title": "get_professional_detailsArguments"
}

search_professionals_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_professionals_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_salonsArguments"
}

get_salon_details

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

Parameters1

salon_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "salon_id": {
      "title": "Salon Id",
      "type": "integer"
    }
  },
  "required": [
    "salon_id"
  ],
  "title": "get_salon_detailsArguments"
}

search_salons_by_text

Free-text/semantic search over Indian beauty salons.

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_salons_by_textArguments"
}

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

Parameters10

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
category	any	optional
tag	any	optional
include_past	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Category"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "include_past": {
      "default": false,
      "title": "Include Past",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_eventsArguments"
}

get_event_details

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

Parameters1

event_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "title": "Event Id",
      "type": "integer"
    }
  },
  "required": [
    "event_id"
  ],
  "title": "get_event_detailsArguments"
}

search_events_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_events_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_apparelArguments"
}

get_apparel_details

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

Parameters1

apparel_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "apparel_id": {
      "title": "Apparel Id",
      "type": "integer"
    }
  },
  "required": [
    "apparel_id"
  ],
  "title": "get_apparel_detailsArguments"
}

search_apparel_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_apparel_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_sweetsArguments"
}

get_sweets_details

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

Parameters1

sweets_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "sweets_id": {
      "title": "Sweets Id",
      "type": "integer"
    }
  },
  "required": [
    "sweets_id"
  ],
  "title": "get_sweets_detailsArguments"
}

search_sweets_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_sweets_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_studiosArguments"
}

get_studio_details

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

Parameters1

studio_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "studio_id": {
      "title": "Studio Id",
      "type": "integer"
    }
  },
  "required": [
    "studio_id"
  ],
  "title": "get_studio_detailsArguments"
}

search_studios_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_studios_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 15,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_servicesArguments"
}

get_service_details

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

Parameters1

service_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "title": "Service Id",
      "type": "integer"
    }
  },
  "required": [
    "service_id"
  ],
  "title": "get_service_detailsArguments"
}

search_services_by_text

Free-text/semantic search over Indian community services.

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_services_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_communityArguments"
}

get_community_details

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

Parameters1

community_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "community_id": {
      "title": "Community Id",
      "type": "integer"
    }
  },
  "required": [
    "community_id"
  ],
  "title": "get_community_detailsArguments"
}

search_community_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_community_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_legalArguments"
}

get_legal_details

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

Parameters1

legal_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "legal_id": {
      "title": "Legal Id",
      "type": "integer"
    }
  },
  "required": [
    "legal_id"
  ],
  "title": "get_legal_detailsArguments"
}

search_legal_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_legal_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_educationArguments"
}

get_education_details

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

Parameters1

education_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "education_id": {
      "title": "Education Id",
      "type": "integer"
    }
  },
  "required": [
    "education_id"
  ],
  "title": "get_education_detailsArguments"
}

search_education_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_education_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_realestateArguments"
}

get_realestate_details

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

Parameters1

realestate_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "realestate_id": {
      "title": "Realestate Id",
      "type": "integer"
    }
  },
  "required": [
    "realestate_id"
  ],
  "title": "get_realestate_detailsArguments"
}

search_realestate_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_realestate_by_textArguments"
}

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

Parameters9

lat	any	optional
lng	any	optional
radius_miles	number	optional
city	any	optional
state	any	optional
tag	any	optional
open_now	boolean	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "radius_miles": {
      "default": 25,
      "title": "Radius Miles",
      "type": "number"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Tag"
    },
    "open_now": {
      "default": false,
      "title": "Open Now",
      "type": "boolean"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "get_indian_financeArguments"
}

get_finance_details

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

Parameters1

finance_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "finance_id": {
      "title": "Finance Id",
      "type": "integer"
    }
  },
  "required": [
    "finance_id"
  ],
  "title": "get_finance_detailsArguments"
}

search_finance_by_text

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

Parameters5

query	string	required
city	any	optional
state	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_finance_by_textArguments"
}

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

Parameters7

query	string	required
city	any	optional
state	any	optional
lat	any	optional
lng	any	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "city": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "City"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lat"
    },
    "lng": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Lng"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_allArguments"
}

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

Parameters2

query	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 6,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_festival_datesArguments"
}

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

Parameters3

query	string	required
vertical	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "vertical": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Vertical"
    },
    "limit": {
      "default": 6,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_knowledgeArguments"
}

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

Parameters8

vertical	string	required
name	string	required
city	string	optional
state	string	optional
address_full	string	optional
phone	string	optional
website	string	optional
contact_email	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "vertical": {
      "title": "Vertical",
      "type": "string"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "city": {
      "default": "",
      "title": "City",
      "type": "string"
    },
    "state": {
      "default": "",
      "title": "State",
      "type": "string"
    },
    "address_full": {
      "default": "",
      "title": "Address Full",
      "type": "string"
    },
    "phone": {
      "default": "",
      "title": "Phone",
      "type": "string"
    },
    "website": {
      "default": "",
      "title": "Website",
      "type": "string"
    },
    "contact_email": {
      "default": "",
      "title": "Contact Email",
      "type": "string"
    }
  },
  "required": [
    "vertical",
    "name"
  ],
  "title": "submit_listingArguments"
}

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

Parameters1

movie_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "movie_id": {
      "title": "Movie Id",
      "type": "integer"
    }
  },
  "required": [
    "movie_id"
  ],
  "title": "get_movie_detailsArguments"
}

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.

Parameters1

sponsor_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "sponsor_id": {
      "title": "Sponsor Id",
      "type": "integer"
    }
  },
  "required": [
    "sponsor_id"
  ],
  "title": "get_h1b_sponsor_detailsArguments"
}

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

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 8,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_community_questionsArguments"
}

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

Parameters1

slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "title": "Slug",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "title": "get_community_answersArguments"
}

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

Parameters3

city	string	optional
state	string	optional
languages	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "default": "",
      "title": "City",
      "type": "string"
    },
    "state": {
      "default": "",
      "title": "State",
      "type": "string"
    },
    "languages": {
      "default": "",
      "title": "Languages",
      "type": "string"
    }
  },
  "title": "get_today_highlightsArguments"
}

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

Parameters4

city	string	optional
state	string	optional
vertical	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "default": "",
      "title": "City",
      "type": "string"
    },
    "state": {
      "default": "",
      "title": "State",
      "type": "string"
    },
    "vertical": {
      "default": "",
      "title": "Vertical",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_offersArguments"
}

ask_community_question

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

Parameters4

question	string	required
member_email	string	required
city	string	optional
vertical	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "member_email": {
      "title": "Member Email",
      "type": "string"
    },
    "city": {
      "default": "",
      "title": "City",
      "type": "string"
    },
    "vertical": {
      "default": "",
      "title": "Vertical",
      "type": "string"
    }
  },
  "required": [
    "question",
    "member_email"
  ],
  "title": "ask_community_questionArguments"
}

save_place

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

Parameters3

member_email	string	required
vertical	string	required
listing_id	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "member_email": {
      "title": "Member Email",
      "type": "string"
    },
    "vertical": {
      "title": "Vertical",
      "type": "string"
    },
    "listing_id": {
      "title": "Listing Id",
      "type": "integer"
    }
  },
  "required": [
    "member_email",
    "vertical",
    "listing_id"
  ],
  "title": "save_placeArguments"
}

unsave_place

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

Parameters3

member_email	string	required
vertical	string	required
listing_id	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "member_email": {
      "title": "Member Email",
      "type": "string"
    },
    "vertical": {
      "title": "Vertical",
      "type": "string"
    },
    "listing_id": {
      "title": "Listing Id",
      "type": "integer"
    }
  },
  "required": [
    "member_email",
    "vertical",
    "listing_id"
  ],
  "title": "unsave_placeArguments"
}

list_saved_places

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

Parameters2

member_email	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "member_email": {
      "title": "Member Email",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "member_email"
  ],
  "title": "list_saved_placesArguments"
}

follow_city

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

Parameters2

member_email	string	required
city	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "member_email": {
      "title": "Member Email",
      "type": "string"
    },
    "city": {
      "title": "City",
      "type": "string"
    }
  },
  "required": [
    "member_email",
    "city"
  ],
  "title": "follow_cityArguments"
}

list_follows

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

Parameters1

member_email

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "member_email": {
      "title": "Member Email",
      "type": "string"
    }
  },
  "required": [
    "member_email"
  ],
  "title": "list_followsArguments"
}

README.md19 KBView on GitHub

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

json

{ "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_<category>, search_<category>_by_text, get_<category>_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)

code

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

powershell

# 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

Command	Purpose
`init-db`	Apply SQL migrations (extensions, tables, indexes).
`scrape --metro <name>`	Run the OSM scraper for a metro bbox into `restaurant_raw`.
`process`	Clean/score unprocessed raw rows; auto-apply low-risk, queue high-risk.
`approvals`	List pending approval-queue items.
`approve <id>` / `reject <id>`	Resolve an approval item.
`outreach [--limit N]`	Draft claim outreach for unclaimed restaurants (creates claim links + messages).
`verify-claim <token>`	Owner-side: verify a claim token and take ownership.
`agents`	List the registered autonomous agents.
`agent <name>`	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.
`seed`	Load fictional seed restaurants for local testing (no scrape needed).
`enrich`	Backfill region/dietary cultural tags on under-tagged restaurants.
`deactivate-stale [--days 60]`	Mark unclaimed listings not seen recently as inactive.
`approval-digest`	Human-readable summary of the pending approval queue.
`feedback --id N --field F --value V`	Submit a field correction (applied by the feedback agent).
`scrape --metro usa`	Nationwide sweep (occasional; slower than a single metro).
`feature --id N [--days 30 \| --permanent]`	Mark a paid featured listing.
`unfeature --id N`	Remove a featured listing.
`backfill-embeddings [--all]`	(Re)compute embeddings for canonical rows.
`stats`	Row 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

powershell

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)

powershell

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

Agent	Does
`discovery`	Reports metro coverage and proposes scrape targets.
`scraper`	Runs every scraper across every metro into `restaurant_raw`.
`cleaner`	Processes raw → canonical via clean/score/approval.
`outreach`	Drafts claim outreach for eligible unclaimed restaurants.
`monitoring`	Detects anomalies (backlogs, scraper failures, stale data) → `agent_alerts`.
`submission`	Submits the MCP to directories (manual stub for now).

powershell

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 <name>; 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 infra" principle. Own table (temples), own OSM scraper (amenity=place_of_worship + religion), own agents (temple_scraper, temple_cleaner), own MCP tools. Cultural enrichment infers deity (Venkateswara, Krishna, Lakshmi…) and region (Punjabi for Sikh, Gujarati for Swaminarayan, Telugu for Venkateswara…) from the name.

powershell

python -m indo_usa_mcp.cli temples-scrape --metro bay_area
python -m indo_usa_mcp.cli temples-process
python -m indo_usa_mcp.cli temples-stats
python -m indo_usa_mcp.cli temples-query --religion hindu --city Fremont
python -m indo_usa_mcp.cli temples-query --text "swaminarayan gujarati mandir"

Phase 2: Groceries vertical

Same recipe as temples — independent groceries table + OSM scraper (grocery-type shops whose name signals Indian groceries: Patel, India, Apna, Swad, Masala…) + own agents (grocery_scraper, grocery_cleaner) + 3 MCP tools. Infers store_type and region_tag.

powershell

python -m indo_usa_mcp.cli groceries-scrape --metro bay_area
python -m indo_usa_mcp.cli groceries-process
python -m indo_usa_mcp.cli groceries-query --city Fremont
python -m indo_usa_mcp.cli groceries-query --text "patel brothers indian grocery"

Admin dashboard, reporting & owner portal

The web app (:8080) now serves three audiences:

Public/owner — /, /claim, /manage, /upgrade (existing)
Admin (/admin/*, password-gated) — overview KPIs, cross-vertical data control (browse/search/edit/feature/deactivate/soft-delete), Geography drill-down (country → state → city, click to filter records), Quality control (records flagged for missing region/contact/geo/city + duplicate groups, with a one-click city/state normalizer), approvals & feedback queues, agents (last-run health, run-now, resolve alerts), Traffic (every MCP tool call logged: by tool / agent-client / day, plus most-shown listings), payments, and reports. Set ADMIN_PASSWORD to enable; blank disables it.
Owners see a reach number per listing in the portal ("shown N times by AI assistants", from per-listing impression tracking) — a concrete hook for selling featured placement.
Customer portal (/portal/*) — owners sign in via passwordless magic-link email and manage all their listings across verticals (edit, featured status, upgrade).

Daily report: the reporting agent computes a health + growth snapshot nightly into daily_reports, shows it on /admin/reports, and emails it (via SMTP) to REPORT_EMAIL. Run on demand with python -m indo_usa_mcp.cli report.

Security: enable HTTPS (the Caddy tls profile) and set a strong ADMIN_PASSWORD + random SECRET_KEY before exposing /admin publicly.

Phase 2: Professionals vertical (doctors/health)

Indian-American healthcare professionals — doctors, dentists, clinics, pharmacies — found from OSM healthcare amenities + an Indian-name signal (surnames / Ayurveda). Same recipe as the other verticals: own professionals table, scraper, agents (professional_scraper, professional_cleaner), 3 MCP tools, plus profession_type/speciality filters. Because name-matching is heuristic, each record carries a confidence_score and the admin Quality view helps curate false positives.

powershell

python -m indo_usa_mcp.cli professionals-scrape --metro bay_area
python -m indo_usa_mcp.cli professionals-process
python -m indo_usa_mcp.cli professionals-query --type dentist --city "San Jose"

Phase 2: Salons vertical (beauty / threading)

Indian beauty salons — eyebrow threading, henna/mehndi, hair, bridal — from OSM hairdresser/beauty shops with a strong South-Asian service/name signal. Same recipe; tags capture services (threading, henna, bridal…). Best OSM coverage of the verticals so far.

powershell

python -m indo_usa_mcp.cli salons-scrape --metro bay_area
python -m indo_usa_mcp.cli salons-process
python -m indo_usa_mcp.cli salons-query --tag threading --city Sunnyvale

Phase 2: Events vertical (automated, admin-approved)

Indian-American community events (festivals, garba, concerts, puja). Fully automated — an agent auto-discovers iCal feeds by scanning the websites of orgs already in the database (temples first) for calendar links, and agents ingest events from those feeds plus any in EVENT_ICAL_FEEDS. The cleaner auto-approves high-confidence events and queues the rest under Admin → Events for one-click approval (no manual entry). Past events are kept, not deleted — they're date-filtered out of upcoming results (get_indian_events returns upcoming by default; include_past=true for history) and an 18-month retention purges very old ones.

powershell

python -m indo_usa_mcp.cli events-discover     # scan org websites for iCal feeds
python -m indo_usa_mcp.cli events-scrape      # ingest configured + discovered iCal feeds
python -m indo_usa_mcp.cli events-process     # auto-approve / queue for admin
python -m indo_usa_mcp.cli events-approvals   # list pending
python -m indo_usa_mcp.cli events-query --city Edison --category garba

Connecting an MCP client

Point any MCP client (Claude Desktop, etc.) at:

json

{
  "mcpServers": {
    "indo-usa-diaspora": {
      "command": "python",
      "args": ["-m", "indo_usa_mcp.server"],
      "env": { "DATABASE_URL": "postgresql://diaspora:diaspora@localhost:5433/diaspora" }
    }
  }
}

Deployment (VPS, blueprint §10)

The full hosted stack — Postgres + MCP server (HTTP) + agent worker — is in docker-compose.prod.yml:

powershell

$env:POSTGRES_PASSWORD = "choose-a-strong-password"
docker compose -f docker-compose.prod.yml up -d --build

server runs migrations (idempotent) then serves MCP over streamable-http on :8000.
worker runs the agent scheduler (scrape → clean → monitor …); it waits for the schema before starting, so service start order doesn't matter.
db stays on the internal network (not published).

Put a TLS-terminating reverse proxy (Caddy/nginx/Traefik) in front of :8000 for HTTPS, and add a firewall + scheduled pg_dump backups. The MCP endpoint is https://<host>/mcp.

Checking it with MCP Inspector

The standard visual way to exercise the tools:

powershell

# stdio (local)
npx @modelcontextprotocol/inspector .\.venv\Scripts\python.exe -m indo_usa_mcp.server

# or point the Inspector at a running HTTP server: http://localhost:8000/mcp

Guardrails honoured

Public data only (OSM/ODbL), no login-required scraping, no personal data, rate-limited.
Confidence scoring, soft deletes, full version history.
Human approval for high-risk updates; is_featured is an explicit, visible flag.

Status / roadmap

Phase 1 is implemented and runs end-to-end: schema + versioning + approval queue, the pipeline, two scrapers (OSM + Wikidata), all 5 MCP tools, semantic (pgvector) search, outreach & claiming, six autonomous agents with a scheduler, seed fixtures, and a hosted deployment stack. Remaining "last mile": real outreach channel delivery, a claim web page, the Approval-Assistant + Feedback agents, monetization logic, and production hardening (HTTPS, backups). Each future vertical (temples, events, groceries…) gets its own table/scrapers/tools but shares this infra.

Install

Tools (66)

get_indian_restaurantsget_indian_movies_in_theaterssearch_h1b_sponsorsget_restaurant_detailssearch_restaurants_by_textsubmit_correctionsubmit_reviewget_reviews

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://namasteamerica.us/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "namaste-america": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://namasteamerica.us/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.