How to manage your villa listings with an AI agent

A client needs a villa for a two-hour photoshoot. Before replying, you need to find availability, check the price and make sure the slot leaves enough time to prepare the venue. That information already exists in VillaSlot. An AI agent can look it up for you and prepare the next steps from your request.

Getting started takes two things: the VillaSlot skill and an API key for your organization. The skill tells the agent how to use the application. The key gives it access to your data with your permissions.

What the agent can do

The agent works with villa listings and bookings inside VillaSlot. It does not automatically publish listings on Airbnb or other platforms.

Creating or editing villas and rates requires an owner or admin role. Members retain the customer and booking operations allowed by their permissions.

1. Install the VillaSlot skill

In a terminal in the environment where your agent works, run:

npx skills add https://github.com/mikecodeur/skills --skill villaslot

Choose your agent in the installer. Detailed guides are available for Claude Code, Codex, OpenClaw and Hermes. The agent documentation is in English.

If your agent runs on a server, install the skill on that server. Installing it on your computer does not automatically configure a remote environment.

2. Generate an API key

Sign in to VillaSlot and open Account → API Keys. Create a key for the organization whose villas you want to manage.

Make the key available in your agent's environment as VILLASLOT_API_KEY. Also set the service address:

export VILLASLOT_BASE_URL="https://www.villaslot.io"

3. Start with a read

Before requesting a change, check that the agent can access the right organization:

Use the villaslot skill and the API key from your environment.
Show my organization name and timezone, then list my active villas
with their priced durations. Do not change anything.

This first request checks the context. The agent must use the organization's timezone for slots, even if your computer is in another country.

4. Turn a client request into a booking

Provide an exact date, a duration and the venue:

Find a two-hour slot at Garden Villa on October 20, 2026, after 10:00
in the organization's timezone. Show availability and the price.
Wait for my choice before creating the booking.

Once you choose a slot, ask the agent to find the customer or create their record, then state whether the booking should be provisional or confirmed. A provisional booking can already block the slot; it is more than a draft in a conversation.

The server checks availability again when creating the booking. If someone else books the slot in the meantime, the agent should offer another option instead of repeating the same attempt.

Change rates without losing the rest of the grid

When changing a price, state what should be preserved:

Read Garden Villa's full rate grid. Prepare a two-hour rate of
1,500,000 IDR, preserve all other durations and show me the grid
before saving it.

The API replaces the entire grid. Opening hours work the same way: omitting a day closes it. A precise instruction prevents a small edit from removing useful data.

What stays in the application

The current API does not record manual payments, collect payments through Stripe, issue refunds or create overnight bookings. Confirming a booking does not make it paid. These operations remain in the relevant application workflows.

For an import, request a report of matched records and rejected rows. The agent should save created IDs to avoid duplicates after an interruption. There is no API parameter to disable emails: if the import must be silent, configure delivery settings in the application first.

A simple first use

Start with a task you know well: reading tomorrow's bookings or checking a villa's availability. Compare the result with your calendar, then gradually expand the operations you delegate to the agent.

The Agents guide brings together installation and connection examples. You keep the same villas, customers and rules; the agent becomes another way to work with your organization.