# Born to Banger

> Event entertainment marketplace for activities, workshops, and booking workflows in Delhi NCR, with REST and MCP interfaces for discovery, pricing, search, and bookings.

Use this file as operational guidance for AI crawlers, agents, and MCP clients.
For live schemas and tool definitions, fetch discovery and manifest endpoints at runtime instead of relying on static prompt text.

## Key Links

- [Website](https://www.borntobanger.in): Main public website.
- [Developers Guide](https://www.borntobanger.in/developers): Canonical technical docs.
- [API Discovery](https://www.borntobanger.in/api/discover): Machine-readable capability and workflow map.
- [MCP Manifest](https://www.borntobanger.in/api/mcp): MCP transport metadata and tool registration endpoint.
- [Robots](https://www.borntobanger.in/robots.txt): Crawl policy.

## Offerings

- [Activities](https://www.borntobanger.in/activities): Interactive entertainment options for social and corporate events.
- [Occasions](https://www.borntobanger.in/occasions): Occasion-specific planning paths such as birthdays, weddings, and festive events.
- [Workshops](https://www.borntobanger.in/workshops): Skill-based and engagement workshops for teams, schools, and communities.
- [Locations](https://www.borntobanger.in/locations): Service coverage and city/location availability context.
- [Gifting](https://www.borntobanger.in/gifting): Curated gifting experiences aligned with events and celebrations.

## Authentication and Stability

- [MCP OAuth metadata](https://www.borntobanger.in/.well-known/oauth-protected-resource/api/mcp): Present when OAuth-protected MCP is enabled.
- [API discovery version contract](https://www.borntobanger.in/api/discover): Current API version and high-level feature map.

API auth is not required for core REST endpoints at the application layer.
MCP auth can be enforced by server configuration.
Clients should refresh discovery on startup and periodically to handle updates.

## REST Endpoints

- [GET /api/discover](https://www.borntobanger.in/api/discover): Machine-readable API discovery and workflow map.
- [GET /api/activities](https://www.borntobanger.in/api/activities): List all activities; returns success, data[], count.
- [GET /api/locations](https://www.borntobanger.in/api/locations): List service locations and multipliers; returns success, data[], count.
- [GET /api/workshops](https://www.borntobanger.in/api/workshops): List workshops; returns success, data[], count.
- [GET /api/search](https://www.borntobanger.in/api/search): Search and filter activities via q, category, location, min_price, and max_price.
- [GET /api/pricing](https://www.borntobanger.in/api/pricing): Calculate location-adjusted pricing using activity_slug and location_slug, optional quantity.
- [GET /api/bookings](https://www.borntobanger.in/api/bookings): Booking API documentation and integration status.
- [POST /api/bookings](https://www.borntobanger.in/api/bookings): Create booking request with name, email, phone, location_slug, and one of activity_slug or workshop_id.

## MCP

- [POST /api/mcp](https://www.borntobanger.in/api/mcp): HTTP JSON-RPC 2.0 transport endpoint for MCP method calls.
- [GET /api/mcp](https://www.borntobanger.in/api/mcp): Manifest discovery endpoint.

Available tools include discover_services, get_service_details, calculate_pricing, get_occasions, create_booking, list_workshops, and list_locations.
For tool calls, clients should parse the JSON string payload commonly returned in result.content[0].text.

## Operational Guidance

- [Search endpoint](https://www.borntobanger.in/api/search): Use live search data before answering user availability questions.
- [Pricing endpoint](https://www.borntobanger.in/api/pricing): Use live pricing before presenting quotes.
- [Bookings endpoint](https://www.borntobanger.in/api/bookings): Validate booking fields client-side before submit.

Common REST success shape includes success, data, and count.
Common REST error shape includes success=false, error, and details.
Observed statuses include 200, 201, 400, 404, and 500.

## Optional

- [Support email](mailto:bookings@borntobanger.in): Primary support channel.
- [Support phone](tel:+918383087735): Operations and booking support.

Escalation note: if booking creation succeeds with warnings, surface warnings for manual operator follow-up.