# Marbella Golf Times

> Boutique tee-time booking service for 40+ premier golf courses on the Costa del Sol, Spain. Real-time availability, instant booking, and concierge-quality service.

## About

Marbella Golf Times is a premier golf tee-time booking platform dedicated to the Costa del Sol region of Spain. We provide real-time availability and instant booking access to over 40 championship and boutique golf courses throughout the region, including courses managed by leading providers like Golfmanager, TeeOne, and Zest Golf. Our platform seamlessly integrates with multiple provider APIs to ensure accurate, up-to-date tee times and pricing for golfers seeking authentic Spanish golfing experiences.

## Key Features

- **Real-time Tee Times** – Live availability updates from multiple golf course management systems
- **40+ Premier Courses** – Comprehensive coverage across Costa del Sol's finest golf destinations
- **Multi-language Support** – Full interface in English and Spanish for international and local golfers
- **Weather Forecasts** – Integrated weather data to help golfers plan their rounds
- **Course Comparison** – Compare facilities, amenities, ratings, and reviews across courses
- **Secure Payments** – Stripe-powered payment processing for safe and reliable transactions
- **Booking Management** – View, modify, and manage your reservations in one place
- **Golfer Profiles** – Track handicaps, performance statistics, and booking history

## AI Agent Integration

Marbella Golf Times is designed to be the world's most AI agent-friendly golf booking platform. We provide multiple integration standards so any AI agent can autonomously discover, search, and book tee times.

### Discovery Standards

| Standard | URL | Description |
|----------|-----|-------------|
| **agents.json** | `/.well-known/agents.json` | Agent discovery with capabilities, tools, auth, and rate limits |
| **OpenAPI 3.1** | `/api/v2/agent/openapi.json` | Full REST API specification with examples and schemas |
| **MCP Server** | `POST /api/v2/mcp` | Model Context Protocol (Streamable HTTP) for direct tool execution |
| **WebMCP** | `navigator.modelContext` | Browser-side MCP tools via `@mcp-b/global` polyfill |
| **llms.txt** | `/llms.txt` | This file — machine-readable platform overview |
| **Schema.org** | Embedded JSON-LD | Structured data for search engines and AI crawlers |

### Agent API v2 (Recommended)

The Agent API v2 at `/api/v2/agent/*` is purpose-built for AI agents. No authentication required. 60 requests/minute rate limit per IP.

**Endpoints:**

- `GET /api/v2/agent/courses` – Search courses (query, city, lat/lng, price range, holes, distance)
- `GET /api/v2/agent/courses/{idOrSlug}` – Full course details by ID or slug
- `GET /api/v2/agent/tee-times?date=YYYY-MM-DD` – Real-time tee time availability across all providers
- `POST /api/v2/agent/bookings` – Create booking, returns Stripe checkout URL
- `GET /api/v2/agent/bookings/{id}` – Check booking status

**Example: Search tee times**
```
GET /api/v2/agent/tee-times?date=2026-03-15&players=2&holes=18&courseId=abc-123
```

**Example: Create booking**
```json
POST /api/v2/agent/bookings
{
  "courseId": "abc-123",
  "date": "2026-03-15",
  "time": "09:30",
  "players": 2,
  "customerName": "John Smith",
  "customerEmail": "john@example.com"
}
```

### MCP Server (Model Context Protocol)

For MCP-compatible AI agents, send JSON-RPC 2.0 messages to `POST /api/v2/mcp`.

**Available tools:**
- `search_golf_courses` – Search and filter courses
- `get_course_details` – Get course information
- `search_tee_times` – Find available tee times
- `create_booking` – Book a tee time with Stripe payment
- `get_booking_status` – Check booking status

### WebMCP (Browser-side)

Five tools registered via `navigator.modelContext` for browser-based AI agents:
- `search_golf_courses`, `get_course_details`, `check_tee_times`, `book_tee_time`, `get_weather`

### External API v1 (Legacy)

Partner API at `/api/v1/external/*` requires API key authentication. For partner registration visit `/partner-onboarding`.

## Key Pages

- **[/](/)** – Homepage with featured course listings, search functionality, and promotional content
- **[/search](/search)** – Advanced tee time search with filters for location, date, players, course rating, and price
- **[/feed](/feed)** – Curated tee time feed showcasing special offers, new availability, and trending courses
- **[/partner-onboarding](/partner-onboarding)** – Partner registration and API key management for golf courses and resellers

## Contact

**Email:** contact@marbellagolftimes.com
**Phone:** +34 951 792 840
**Website:** www.marbellagolftimes.com
**Location:** Costa del Sol, Spain

For partnership inquiries, API integration support, or customer assistance, please reach out through any of the above channels. Our team is available during business hours (Madrid timezone, Europe/Madrid).