> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates

> Vertical-specific MCP server templates for different business types

## Overview

Ready templates are pre-built MCP server images tailored to specific business verticals. Each template exposes tools and resources relevant to that industry — you provide the configuration, Ready handles the rest.

<Info>
  ezForge Ready is currently in development. Templates shown here represent the planned launch verticals.
</Info>

## How templates work

```
Business Profile Data (your answers)
        │
        ▼
Template Engine selects vertical template
        │
        ▼
Configuration injected into container
        │
        ▼
MCP server deployed on ezForge Platform
        │
        ▼
{slug}.ready.ezforge.ai — live and discoverable
```

Templates are **configuration-driven**, not code-generated. The same OCI image serves all businesses in a vertical — your unique data is injected as configuration at deploy time.

## Available templates

### Restaurant

Built for restaurants that want AI agents to browse their menu, answer dietary questions, and accept reservations or orders. The `EZFORGE_READY_CONFIG` carries a structured catalog (`catalog.items[]`) with per-item dietary tag and allergen metadata, plus business-level fields for cuisine type, menu notes, and hours override.

Tools exposed to AI agents:

* `search_menu` — Search menu items by name, category, dietary restriction
* `get_menu_item` — Full details for a specific menu item by ID
* `check_dietary` — List all menu items matching a dietary requirement (e.g., vegan, gluten-free, nut-free)
* `get_hours` — Current and upcoming hours, holiday schedules
* `check_availability` — Table availability for a given party size and date/time
* `request_reservation` — Submit a reservation request
* `place_order` — Submit a takeout/delivery order

#### Feature flags

| Flag                 | Enabled when                         |
| -------------------- | ------------------------------------ |
| `menuBrowsing`       | At least one menu item is configured |
| `onlineOrdering`     | At least one menu item is configured |
| `faq`                | Always enabled                       |
| `appointmentBooking` | Always disabled                      |
| `quoteRequests`      | Always disabled                      |

#### ReadyConfig v2.0 — catalog item shape

Each menu item in `catalog.items[]` has the following shape:

```json theme={null}
{
  "id": "uuid",
  "name": "Margherita Pizza",
  "description": "Fresh tomato, mozzarella, and basil on a thin crust.",
  "categoryId": "cat-0",
  "priceCents": 1299,
  "priceType": "fixed",
  "isAvailable": true,
  "metadata": {
    "dietary_tags": ["vegetarian", "gluten-free"],
    "allergens": ["wheat", "milk"]
  }
}
```

Supported `dietary_tags` values: `vegetarian`, `vegan`, `gluten-free`, `dairy-free`, `nut-free`, `halal`, `kosher`, `spicy`.

Supported `allergens` values (FDA major allergens): `milk`, `eggs`, `fish`, `shellfish`, `tree-nuts`, `peanuts`, `wheat`, `soybeans`, `sesame`.

### Salon & Spa

Tools exposed to AI agents:

* `search_services` — Search services by category with pricing and duration
* `get_service_details` — Full details for a specific service including duration and price
* `check_availability` — Stylist availability slots for a given service and date
* `book_appointment` — Submit an appointment request forwarded to the salon owner for confirmation
* `get_cancellation_policy` — Returns the salon cancellation and rescheduling policy

### Home Services

Built for contractors and field service businesses. This template handles geographic service area verification, quote requests, and contractor credential display — key workflows that differ from retail or hospitality verticals. The `EZFORGE_READY_CONFIG` carries your service catalog (`HomeServicesService[]`), coverage zone (`HomeServicesArea`), and license/insurance records (`HomeServicesCredential[]`).

Tools exposed to AI agents:

* `check_service_area` — Verify whether a zip code is within the contractor's service area
* `get_services` — Available services and pricing ranges, optionally filtered by category
* `request_quote` — Submit a quote request with service type, description, address, and urgency
* `check_availability` — Available 2-hour appointment windows for a service type and date
* `verify_credentials` — Contractor license and insurance verification status

### Retail

Built for independent bookstores, boutiques, and specialty shops. This template handles product search, inventory checks, price lookups, and order submission. The `EZFORGE_READY_CONFIG` carries your product catalog (`RetailProduct[]`) and store policies (return policy, shipping availability, curbside pickup).

Tools exposed to AI agents:

* `search_products` — Search products by name, category, or keyword; supports in-stock filter
* `check_inventory` — Check stock availability and quantity by product name or SKU
* `get_product_details` — Full product details: price, description, stock status, shipping availability
* `place_order` — Submit an order for store pickup, curbside pickup, or shipping

Resources exposed to AI agents:

* `retail://products` — Complete product catalog with categories, prices, and inventory
* `retail://products/{category}` — Products in a specific category
* `retail://store-policies` — Return policy, shipping options, curbside pickup, and online store URL

### Professional Services

Built for accountants, attorneys, financial advisors, insurance brokers, and management consultants. The `EZFORGE_READY_CONFIG` carries your service catalog (`ProfessionalServicesService[]`), consultant directory (`ProfessionalServicesConsultant[]`), and credential records (`ProfessionalServicesCredential[]`).

**Always-available tools:**

* `get_business_info` — Returns the firm name, description, and vertical category
* `get_hours` — Returns office hours for each day of the week
* `get_contact_info` — Returns phone, email, website, and address
* `get_credentials` — Returns firm specializations, licenses, certifications, and insurance

**Service browsing tools** (enabled when services are configured):

* `list_services` — Browse services by name or practice area
* `get_service_details` — Full details including consultation fee and duration

**Consultation booking tools** (enabled when appointment booking is on):

* `check_availability` — Available consultation slots for a service, consultant, and date
* `book_consultation` — Submit a consultation request forwarded to the firm

**Resources exposed to AI agents:**

* `ready://business/profile` — Business name, description, and category
* `ready://business/hours` — Operating hours keyed by day of week
* `professional-services://consultants` — Consultant directory with names, titles, specialties, and availability
* `professional-services://credentials` — Firm credentials, certifications, and insurance
* `professional-services://services` — Full service catalog with practice areas, fees, and durations *(when service browsing enabled)*
* `professional-services://services/{category}` — Services filtered by practice area *(when service browsing enabled)*

## Template architecture

Each template is a pre-built OCI container image that:

1. Reads configuration from the `EZFORGE_READY_CONFIG` environment variable at startup
2. Exposes MCP-compliant tools and resources based on the configuration
3. Runs in an isolated Firecracker microVM on ezForge Platform
4. Supports auto-stop/auto-start (scale-to-zero) like any Platform server

## Custom templates

Don't see your vertical? Use the **Other / Custom** template to deploy a base MCP server exposing business info, hours, and contact details. Additional verticals are added regularly — [let us know](mailto:hello@ezforge.ai) what you need.