For Developers & AI Agents
Event Gurus Developer & Agent API
Event Gurus exposes a public, read-only, zero-authentication JSON API so developers and AI agents can query our Udaipur destination-wedding catalogue programmatically. No sign-up, API key or contact form required.
Quick links
- OpenAPI 3.1 specification (
/openapi.json) - API index (
/api) - MCP server card — endpoint
/mcp(Streamable HTTP) - llms.txt agent guide
- Agent authentication (auth.md)
- API catalog (RFC 9727)
Authentication
None. Every endpoint below is public and read-only. Send a plain GET request — no token, header or key needed. This is a zero-auth, self-serve surface designed for AI agents.
Endpoints
| Operation | Method & Path | Description |
|---|---|---|
getHealth | GET /api/health | Service status & version |
listVenues | GET /api/venues | Five-star palaces & resorts |
listDestinations | GET /api/destinations | Wedding destinations |
listServices | GET /api/services | Planning services |
listFaqs | GET /api/faqs | FAQs |
Example request
curl -s https://eventgurus.co.in/api/venues
# Response
{
"data": [ { "name": "Taj Lake Palace", "slug": "taj-lake-palace", "url": "https://eventgurus.co.in/taj-lake-palace" } ],
"count": 5
}Errors
Unknown endpoints return a structured JSON error (never HTML):
{ "error": { "code": "not_found", "status": 404, "message": "No such API endpoint", "hint": "See /openapi.json" } }MCP (Model Context Protocol)
Point an MCP client at https://eventgurus.co.in/mcp (Streamable HTTP). The server card is at /.well-known/mcp/server-card.json and exposes read-only tools such as search_venues.
