Give AI assistants a free, read-only link to your feed’s listings so they can answer guest questions and send guests to the booking page on your own site.
What it does #
Guests increasingly ask an AI assistant to find them a place to stay before they ever open a website. If the assistant cannot see your listings, it recommends someone else’s. AI Agents gives you a link for one feed that an assistant such as Claude can connect to and read. For readers who know the term, the link is an MCP server. The feature is free.
Once connected, an assistant can:
- Search your published listings by dates, guests, price and amenities.
- Read one listing: description, amenities, photos, guest rating and price range.
- Check whether dates are open and what the stay would cost.
- Link a guest to the booking page for that stay on your own site, with the dates and party size already filled in.
For example, a guest asks an assistant for “a 3-bedroom for 2 adults, 2 children and a dog, March 12 to 16.” The assistant searches your feed for pet-friendly listings with at least three bedrooms, checks those dates against your calendar, and replies with the matching listings, a price for the stay, and a link to book each one on your website.
Availability comes from the calendar HomeRunner already syncs from your PMS, so answering a question costs your PMS nothing. When the assistant asks about a specific stay that the calendar shows as open, HomeRunner fetches a live total that includes fees and taxes. When live pricing is not available, the assistant gets an indicative total that is clearly marked as excluding fees and taxes, and it is told to confirm the final price on your booking page. Usage is capped per feed to protect your PMS from a busy or misbehaving assistant. The AI Agents page shows the fair-use limits for your site.
Before you turn it on, know how the link behaves:
- Share it freely. The link is public by design. It is not a login and carries nothing private. Publish it wherever your guests will find it, so they can add it to their own assistant.
- It exposes the same listing information your public website already shows. Listings you have not published to this feed are never included.
- It is read-only. An assistant can never read guest names, emails, phone numbers or messages. It can never read reservations, payments, payouts or any financial record. It can never change anything.
- You stay in control. Turning access off or replacing the link stops the old link immediately, for every assistant that uses it.
How to turn it on #
1. Open the feed’s AI Agents tab #
In the HomeRunner Dashboard, open Feeds, select the feed you want assistants to read, and click the AI Agents tab. If you have not set up a feed yet, start with Getting started with feed.
2. Read what an assistant can see #
The What an agent can see card lists what an assistant can read and what it can never read, and states that anyone holding the link can read that data without signing in. Read it before enabling access, because the link you are about to create is public.
3. Enable agent access #
Click Enable agent access. HomeRunner creates the link for this feed, and the badge at the top of the page switches to On.
4. Copy your link #
Your link appears in the Your endpoint card. Click Copy link. The link looks like this:
https://central.homerunner.io/mcp/s/YOUR-KEYBelow the link, the page shows when an assistant last used it and how many requests it made in the last 7 days. Until an assistant connects, this line reads “No agent has used this link yet.”
5. Test your link #
Click Test my link in the Your endpoint card. HomeRunner connects to your link from its own side, the way an assistant would, and tells you what came back.
A pass lists the tools an assistant can use right now. A failure names the cause and the one thing that fixes it — agent access is off, the link is not the one on record for this site, the platform is paused, or the site is not being served. Testing changes nothing, and it never shows up in Last agent request or the 7-day count: those stay a signal that someone else used your link.
6. Connect an assistant #
Paste the link wherever your assistant lets you add a connector or MCP server. The Connect an assistant card gives you three ready-to-paste snippets, each with its own Copy button. The snippets on the page already contain your real link. The examples below use a placeholder.
Claude Code. One command in a terminal:
claude mcp add --transport http homerunner "https://central.homerunner.io/mcp/s/YOUR-KEY"Claude Code project config, or any assistant that reads a generic MCP config file:
{
"mcpServers": {
"homerunner": {
"type": "http",
"url": "https://central.homerunner.io/mcp/s/YOUR-KEY"
}
}
}MCP Inspector. A quick check, run in a terminal, that the link responds and lists its three tools:
npx @modelcontextprotocol/inspector --cli "https://central.homerunner.io/mcp/s/YOUR-KEY" --transport http --method tools/listAs the page notes, tools/list is the smoke test. Swap in --method tools/call --tool-name search_listings to try a real query, or drop --cli for the interactive UI. Test my link on the page runs the same check from HomeRunner’s side, with nothing to install.
7. Turn it off or replace the link #
- Turn it off. Click Turn off agent access, then confirm with Yes, turn it off. The link stops working immediately. If you enable access again later, you get a brand-new link. A link you turned off never comes back to life.
- Replace the link. Click Replace this link and confirm with Create new link. This stops the current link immediately. Every assistant already using it, including any your guests added themselves, silently stops working, and you have no way to reach them with the new link. Only do this if that is what you want.
Both actions ask you to confirm before anything changes. Keep it on and Keep current cancel.
Settings #
| Setting | What it controls |
|---|---|
| Enable agent access | Creates the link for this feed and turns access on. Off by default. |
| Copy link | Copies your link to the clipboard so you can paste it into an assistant. |
| Test my link | Asks HomeRunner to connect to your link and reports what an assistant would get: the tools it can use, or the reason it was refused. Changes nothing, and never appears in Last agent request or the 7-day count. |
| Replace this link | Replaces the link. The old link stops working immediately for every assistant using it, including any your guests added. Asks you to confirm first. |
| Turn off agent access | Withdraws access. The link stops working immediately. Asks you to confirm first. Enabling again later creates a new link. |
| Copy (in Connect an assistant) | Copies a ready-to-paste connection snippet for Claude Code, a generic MCP config file, or MCP Inspector. |
| On / Off badge | Shows whether agent access is currently enabled for this feed. Display only. |
| Last agent request | Shows the date and time of the last request from an assistant and the number of requests in the last 7 days, or “No agent has used this link yet.” Display only. |
| Fair-use limits | Shows the per-minute and per-day request caps for this site. Display only. |
Tips #
- Why is my link not responding? Press Test my link on the AI Agents page first: it tries the link from HomeRunner’s side and names the cause, instead of leaving you to guess between the three common ones. Agent access may be paused across the whole platform; the AI Agents page shows a notice when that is the case, and the link starts working again as soon as the pause lifts, with no action from you. The link may have been replaced or turned off; the page always shows the current link, so copy it again. Or the feed itself is archived or suspended, in which case the link stops responding until the feed is live again.
- Assistants send guests to your site to book. Every booking link points to the listing’s page on your own website with the dates and party size applied, so bookings, payments and guest data stay where they already are. Nothing is booked through the assistant.
- Pair it with the AI Booking Channel. Toolkit: AI Booking Channel publishes crawlable feeds and an llms.txt file so assistants can discover your listings on their own. AI Agents lets an assistant you connect directly search and price them live.
- Prices are indicative until the assistant asks about specific dates. Search results show nightly rates before fees and taxes. A dated availability check returns a live total including fees and taxes when live pricing is available, and otherwise a clearly marked indicative total. Either way, the assistant is told to confirm the final price on your booking page. Availability checks cover stays of up to 90 nights.
- Listings without a synced calendar are treated as open. If your PMS connection does not publish a calendar for a listing, the assistant is told to confirm availability before calling that listing free, rather than hiding it from guests.
- Page not loading? The message “Couldn’t load agent access” means a temporary problem reaching HomeRunner. Your settings and your link are unchanged. Click Try again.