API Tools
nomadstays.com
Provides an API for accessing NomadStays stay data and creating user accounts.
ENDPOINT 1
https://mcp.nomadstays.com/mcp
MCP server metadata
- Name
- nomadstays-mcp-server
- Version
- 0.7.0
Known tools 76
signupNomadStaysAccountCreates a new NomadStays account on behalf of a person who does not have one yet.
Inferred read-onlygetStaysByContinentReturns stays from the NomadStays database filtered by continent.
Inferred read-onlygetStaysByLocationReturns stays from the NomadStays database that match a location search term.
Inferred read-onlysearchHelpCenterSearch NomadStays Help Center articles from the public knowledgebase endpoint and return matching title/content/slug entries.
Inferred read-onlygetStaysByLifestyleReturns stays from the NomadStays database filtered by lifestyle/genre category (e.
Inferred read-onlygetStaysByWiFiSpeedFind all stays with WiFi download speed greater than 10Mbps, listed and not suspended.
Inferred read-onlygetAllLifestylesReturns all active lifestyle/genre categories available in NomadStays.
Inferred read-onlygetAllAmenitiesList all possible amenities in the database, grouped into Stay Amenities (referenced by tbStaysFacilities) and Room Amenities (referenced by tbStaysRoom.
Inferred read-onlycheckStayAvailabilityCheck if a specific stay is available for given check-in and check-out dates.
Inferred read-onlyfindNearestAvailabilityFind the nearest available dates when requested dates are not available.
Inferred read-onlygetAvailabilityByMonthGet all available booking windows in a specific month that meet the minimum length of stay requirement.
Inferred read-onlygetRoomAvailabilityCheck a specific room's availability for each night in a date range.
Inferred read-onlygetRoomAmenitiesGet comprehensive list of all facilities and amenities for a specific room, including WiFi metrics (download/upload speed, jitter).
Potential side effectsgetMyStayDetailGet the current title, description, and listed status for one of your Stays.
Inferred read-onlygetMyStayOnboardingStatusGet the Stay's listing-completion scores — the same six 'Listing Completion' cards shown on the Stay dashboard (Stay Details, Availability, Rooms, Packages, Wi-Fi, Operator Information), plus an overall completion percentage.
Inferred read-onlygetMyStayRoomsList all rooms currently configured on one of your Stays, including bed setup, occupancy, facilities (resolved to names, not just IDs), and every room/workspace photo as a viewable CDN URL.
Inferred read-onlygetMyStayPackagesList all pricing packages on one of your Stays, including their full price tiers (days, buy price, sell price, comparison price, listed status).
Inferred read-onlygetMyStayOrganisationalDataGet a Stay's organisational data: address, check-in/out policy, pets/children/parking, cancellation policy, tourism/land-registration numbers.
Inferred read-onlygetMyBusinessProfileGet the host account's business profile: legal business name, VAT/business registration numbers, whether registered as a business entity.
Inferred read-onlygetRoomTypeOptionsList valid room types for a specific Stay's rooms (roomTypeFK in createStayRoom/updateStayRoom).
Inferred read-onlygetRoomFacilityOptionsList every room-level amenity/facility option available (roomFacilityFk in createStayRoom/updateStayRoom) — e.
Inferred read-onlycreateStayPackageCreate a new pricing package on a Stay, optionally with initial price tiers.
Potential side effectsdeleteStayPackagePermanently delete a pricing package and all its price tiers from a Stay.
Potential side effectsgetCurrencyOptionsList valid currency ids/codes for use as a package's currencyFK.
Inferred read-onlyupdateStayOrganisationalDataUpdate a Stay's organisational data: address, check-in/out policy, pets/children/parking, cancellation policy, accommodation type, tourism/land-registration numbers, 'Why Choose Us' reasons, and more.
Potential side effectsupdateHostBusinessProfileUpdate the host account's business profile (legal business name, VAT/business registration numbers).
Potential side effectsgetMyStayContactsGet a Stay's contact/owner/manager details and social media links: owner name/email/mobile, manager (day-to-day contact person) name/email/mobile, booking email/phone/mobile, host display name, and website/Facebook/Twitter/YouTube/Instagram/TikTok/LinkedIn links.
Potential side effectsupdateStayContactsUpdate a Stay's contact/owner/manager details and social media links.
Potential side effectsgetMyStayFacilitiesGet the available options AND current selections for one facility/checkbox group on a Stay — e.
Inferred read-onlyupdateStayFacilitiesSet which options are selected for one facility/checkbox group on a Stay — e.
Inferred read-onlygetFacilityGroupsList every facility/checkbox group name that exists on the platform (e.
Inferred read-onlygetStayTypeOptionsList valid values for a Stay's 'Main Accommodation Type' (stayTypeId in updateStayOrganisationalData).
Inferred read-onlygetCountryOptionsList valid values for a Stay's country (countryId in updateStayOrganisationalData), with each country's name and 2-letter code.
Inferred read-onlygetCancellationPolicyOptionsList valid values for a Stay's cancellation policy (cxPolicyId in updateStayOrganisationalData).
Inferred read-onlygetAdditionalInformationOptionsList valid values for one of the Additional Information picklists used in updateStayOrganisationalData: Children Allowed, Pets Allowed, or Parking.
Inferred read-onlygetBusinessModelOptionsList valid values for a Stay's listing/business model (businessModelId, read-only — displayed on the Stay but not editable via MCP or the host UI itself).
Inferred read-onlygetMyStayPhotosGet every current photo for a Stay across all areas (listing gallery, main/hero, workspace/coworking gallery, host), each as a full https:// CDN URL an agent can view directly (not just a filename).
Inferred read-onlyreorderStayPhotosChange the display order of a Stay's listing or workspace photo gallery.
Inferred read-onlygetProductInfoLook up a Nomad Stays product's price and purchasability — currently only product 8, the Stay Application fee (EUR 39).
Inferred read-onlypurchaseProductStart a purchase of a Nomad Stays product on the caller's own behalf.
Potential side effectslistStayApplicationsList the caller's Stay Applications (draft and submitted), each with a nextAction hint telling you what's needed next (provide_applicant_details, provide_property_details, pay_application_fee, submit, awaiting_review, or accepted).
Inferred read-onlygetStayApplicationGet the full current state of one Stay Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty.
Inferred read-onlysaveStayApplicationUpdate any subset of fields on an existing, not-yet-submitted Stay Application.
Potential side effectslistExperienceApplicationsList the caller's Experience Applications (draft and submitted), each with a nextAction hint telling you what's needed next (provide_applicant_details, provide_experience_details, pay_application_fee, submit, awaiting_review, or accepted).
Inferred read-onlygetExperienceApplicationGet the full current state of one Experience Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty.
Inferred read-onlysaveExperienceApplicationUpdate any subset of fields on an existing, not-yet-submitted Experience Application.
Potential side effectssubmitExperienceApplicationSubmit a completed Experience Application for human review.
Inferred read-onlyquoteStayBookingGet a server-computed price and availability quote for booking a Stay package on the caller's own behalf.
Inferred read-onlybookStayCreate a real booking from a quoteId returned by quoteStayBooking, and return a hosted checkoutUrl.
Potential side effectslistMyBookingsList all Stay bookings owned by the caller's own account, most recent first, with each one's current status.
Inferred read-onlylistCoworkingApplicationsList the caller's Coworking Applications (draft and submitted), each with a nextAction hint (provide_coworking_details, submit, awaiting_review, or accepted).
Inferred read-onlygetCoworkingApplicationGet the full current state of one Coworking Application, including a nextAction hint and (if incomplete) a missingFields list naming exactly which required fields are still empty.
Inferred read-onlysaveCoworkingApplicationUpdate any subset of fields on an existing, not-yet-submitted Coworking Application.
Potential side effectssubmitCoworkingApplicationSubmit a completed Coworking Application for human review.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.nomadstays-mcp-server]
url = "https://mcp.nomadstays.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"nomadstays-mcp-server": {
"type": "http",
"url": "https://mcp.nomadstays.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: nomadstays-mcp-server
Remote MCP URL: https://mcp.nomadstays.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"nomadstays-mcp-server": {
"url": "https://mcp.nomadstays.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"nomadstays-mcp-server": {
"type": "http",
"url": "https://mcp.nomadstays.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "nomadstays-mcp-server",
"transport": "streamable-http",
"url": "https://mcp.nomadstays.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Trust Data Available
BuiltWith Trust API v2 evidence for nomadstays.com was fetched 2026-08-08T10:13:11.237Z and is being refreshed.
nomadstays.com is assessed as Trusted: Domain has an established technology history spanning over a year.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.