Agent Skill · Open source

Teach your AI agent hotel data.

One free skill install. Claude Code, Claude.ai, or Claude Desktop learns the right way to pull rates, reviews, and search results from Booking, Airbnb, Google, and more.

Find the top hotels in Lisbon for September 11 to 13, under €400 for two adults.
Loaded stayapi skill 0.1s
source "stayapi/SKILL.md"
Used booking_lookup_destination 1.12s
query "Lisbon"
Used booking_search_hotels 2.63s
dest_id -2167973 checkin "2026-09-11" checkout "2026-09-13"

Three strong fits under €400 — prices are totals for both nights:

  • The Cloud One Lisbon€3899.1
  • Ibis Parque das Nações€3698.5
  • MASA Hotel & Spa€2938.5

Want free-cancellation options only, or a comparison against Google Hotels prices?

Install the skill Read the skill docs View on GitHub
Free & open source (MIT) 50 free requests on signup Two commands to install
What you can ask

Ask like you'd ask an analyst.
The skill knows the rest.

No tool names to memorize, no parameters to learn. The skill carries the know-how.

>

"Find boutique hotels in Lisbon under €200 for the first week of September."

>

"Pull every review since June for our Booking property into a spreadsheet."

>

"What's the guest sentiment around housekeeping at our Hilton?"

>

"Compare our Airbnb to the three closest competitors."

>

"Check Google reviews for the Bellagio and summarize this month."

>

"Which OpenTable spots near the hotel can seat 8 tonight?"

Six examples. There are countless more: if it's a hotel-data question, the skill routes it to the right workflow.

Set up in 3 minutes

From zero to first answer.

  1. 1

    Get your key

    Sign up for StayAPI. First 50 requests on us. No credit card.

  2. 2

    Install the skill

    Two commands in Claude Code, or upload the .skill file to Claude.ai.

  3. 3

    Start asking

    Type your first hotel question in plain English. The skill kicks in automatically.

How it works

You type plain English. The skill supplies the know-how.

Three real examples of what the skill contributes.

01 Search
You ask

"Top hotels in Lisbon under €400, September 11 to 13."

The skill knows skill: resolve first — booking_lookup_destination → booking_search_hotels(dest_id=-2167973)
You see

"Three fits with guest scores and stay-total prices. No wrong-city guesses, no dropped minus sign."

02 Backfill
You ask

"Every review since June, newest first."

The skill knows skill: sort=recent_desc, paginate until reviewed_date passes the cutoff
You see

"41 reviews, chronologically complete. Relevance order can't do this — the skill knows that."

03 Guardrails
You ask

"Why is the price double what I expected?"

The skill knows skill: price.amount is the total for the stay, not per night — label it that way
You see

"Prices reported correctly the first time. The classic agent misreads are written down so they don't happen."

Start free with 50 requests Book a setup call
Install it

Pick your client. Install once.

Three ways in — all land the same skill.

01

Claude Code

Two slash commands.

claude code 
/plugin marketplace add stayapi/agent-skill
/plugin install stayapi@stayapi
  1. Run both commands inside Claude Code.
  2. Open a new session.
  3. Ask a hotel question — the skill triggers itself.
02

Claude.ai & Desktop

Upload one file.

download 
https://github.com/stayapi/agent-skill/releases/latest
  1. Grab stayapi.skill from the latest release.
  2. Upload under Settings → Capabilities → Skills.
  3. Add the MCP connector for live data.
03

Any agent

It's plain markdown.

bash 
git clone https://github.com/stayapi/agent-skill.git
cp -R agent-skill/skills/stayapi ~/.claude/skills/stayapi
  1. Clone the repo, copy the skill folder.
  2. Works in any skills-aware agent.
  3. No runtime, no build step — markdown only.
Open source The whole skill is on GitHub at stayapi/agent-skill — MIT licensed, versioned releases, issues welcome.
Questions

Things people ask first.

Not here? Email info@stayapi.com or read the full skill docs.

What exactly is an agent skill?

A small folder of instructions (SKILL.md plus reference files) that your AI agent loads automatically when hotel questions come up. It teaches the agent StayAPI's workflows, parameters, and pitfalls — which tool to call, in what order, with which arguments. It's plain markdown, open source under MIT.

Do I need the MCP server too?

They pair. The skill is the knowledge, the MCP server is the connection. With both installed, your agent knows what to do and has the tools to do it. In Claude Code the skill can also drive our REST API directly from the shell; on Claude.ai, add the MCP connector for live data.

Does the skill cost anything?

No — the skill is free and open source. Data calls it triggers count against your normal StayAPI quota, one request per call, exactly like the REST API and MCP server.

Which agents support it?

Claude Code installs it from the plugin marketplace in two commands. Claude.ai and Claude Desktop accept the packaged .skill file upload. Any other skills-aware agent can use it too — it's portable markdown, no runtime.

Do I need a different API key?

No. The same X-API-Key works across REST, MCP, and the skill. One key, one dashboard, one usage log.

Where's the source?

On GitHub at stayapi/agent-skill — versioned releases, MIT license, and the packaged .skill file attached to every release.

Two ways to get set up.

Both end with your agent answering hotel questions. Pick the one that fits your evening.

01 · do it yourself

Sign up. Install the skill.

50 free requests on signup. Two commands in Claude Code or one upload to Claude.ai. Ten minutes from cold to first answer.

Start free
  • Live key in ~30 seconds
  • No credit card
  • Skill is free forever
02 · we'll set it up

Book a call. We'll wire it up.

15 minutes on a call, screen-share, and we set up the skill and connector on your machine with your real properties loaded. Free of charge.

Book a call
  • 15 minutes, working setup
  • Your properties, your prompts
  • Free of charge