Skip to main content
Glama
nomadstays

Nomad Stays

by nomadstays
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

NomadStays MCP Server

An MCP (Model Context Protocol) server that gives AI agents access to Nomad Stays accommodation data — search by country, continent, location, lifestyle, budget, amenities, and availability.

Compatible with Claude, ChatGPT, and any MCP-aware AI agent.

Tools available

Full, current tool list: 76 tools total. See mcp.nomadstays.com for the complete reference with parameters — this README lists them grouped by category; keep both in sync when tools are added or changed.

Search, availability, and reference (public, no auth)

Tool

Description

getStaysByCountry

Search stays by 2-letter country code or country name

getStaysByContinent

Search by continent (Europe, Asia, Africa, etc.)

getStaysByLocation

Free-text search across city, region, location description

getStaysByLifestyle

Filter by lifestyle category (Digital Nomad, Beach, City…)

getStaysByBudget

Find stays within a budget for a given duration and currency

getStaysByAmenities

Filter by amenities (WiFi, Pool, Air Conditioning…)

getStaysByWiFiSpeed

Filter by minimum WiFi download speed (Mbps)

getStayByID

Full details for a single stay

getAllLifestyles

List all available lifestyle categories

getAllAmenities

List all available amenities

checkStayAvailability

Check if a stay is available for given dates

findNearestAvailability

Find nearest available dates when preferred dates are taken

getAvailabilityByMonth

All available windows in a specific month

getRoomAvailability

Per-room availability for a date range

getRoomAmenities

Full amenity list for a specific room including WiFi metrics

searchHelpCenter

Search Nomad Stays help centre articles

getHelpCenterArticle

Fetch a specific help article by ID

listHelpCenterCategories

List all help centre categories

Account signup for AI agents

If the person you're assisting doesn't have a Nomad Stays account yet, use the signupNomadStaysAccount tool to create one for them — no authentication, browser, or CAPTCHA required.

Tool

Description

signupNomadStaysAccount

Create a new Nomad Stays account for someone who doesn't have one yet. Returns pending_email_confirmation — no session or token.

Notes:

  • The account is created but inactive until the human clicks the confirmation link emailed to them — no session or token is returned by this call, and the agent cannot sign in or act as the user itself. This is the trust boundary: it proves a real inbox exists behind the request, standing in for the CAPTCHA/honeypot checks the public browser signup form uses instead.

  • Rate-limited to 2 requests per 5 minutes per source IP, server-side (Controllers/AgentSignupApiController.cs in the main repo).

  • Once the human confirms their email and logs in normally at www.nomadstays.com/Account/Login, they can request an MCP bearer token or complete OAuth (see "Trusted Stay Partner management tools" below) to let their own agent act on their behalf going forward.

Product, purchase, and application tools (require an MCP agent token)

Stay, Experience, and Coworking applications each go through the same list / get / create / save / submit lifecycle. Stay and Experience applications carry a one-time EUR 39 Application Fee (products 8 and 9); Coworking applications have no fee.

Tool

Description

getProductInfo

Look up a product's price and purchasability (product 8 = Stay Application, 9 = Experience Application)

purchaseProduct

Start a purchase on the caller's own behalf; returns a checkoutUrl or resolves as "waived"

getPurchaseStatus

Check whether a purchase has been paid, verified fresh against the payment provider

listStayApplications / getStayApplication / createStayApplication / saveStayApplication / submitStayApplication

Full Stay Application lifecycle

listExperienceApplications / getExperienceApplication / createExperienceApplication / saveExperienceApplication / submitExperienceApplication

Full Experience Application lifecycle (min. 4-day experiences, enforced server-side)

listCoworkingApplications / getCoworkingApplication / createCoworkingApplication / saveCoworkingApplication / submitCoworkingApplication

Full Coworking Application lifecycle — no Application Fee

Booking (require an MCP agent token)

Tool

Description

quoteStayBooking

Price a prospective booking (package, dates, guests) before committing

bookStay

Create a booking on the caller's own behalf; returns a checkoutUrl or resolves as confirmed

getBookingStatus

Check whether a booking is confirmed, verified fresh against the payment provider

listMyBookings

List the caller's own bookings, including needsAction/checkoutUrl for anything still pending

Related MCP server: MCP API Server

Trusted Stay Partner management tools

The tools above are read-only and public (aside from applications, which are self-service but still token-gated). A separate set of tools lets an authorized Trusted Stay Partner's own AI agent read AND write their own listing data — with the same capabilities (no more, no less) as they have via the Nomad Stays admin UI. These require a bearer token issued from the partner's Operator Information page at www.nomadstays.com/stayadmin/user-profile-stays (2FA must be enabled on the account to request one), set as NOMADSTAYS_MCP_AGENT_TOKEN. Every call is scoped server-side to Stays the authenticated account actually owns.

Tool

Description

getMyStays / getMyStayDetail / updateStayDetail

Read/update a Stay's core details (title, description, address, policies)

getMyStayOnboardingStatus

The six "Listing Completion" scores from the Stay dashboard (Stay Details, Availability, Rooms, Packages, Wi-Fi, Operator Information) plus an overall percentage — Wi-Fi is a test-freshness score, not a speed rating

getMyStayRooms / createStayRoom / updateStayRoom / deleteStayRoom

Full room CRUD, including bed sizes, facilities, and photos

getRoomTypeOptions / getRoomFacilityOptions

Reference lookups for valid room types/facilities (differ for boutique vs standard Stays)

uploadStayPhoto / getMyStayPhotos / deleteStayPhoto / reorderStayPhotos

Stay-level photo management, including reordering

deleteRoomPhoto / reorderRoomPhotos

Room-level photo management

getMyStayPackages / createStayPackage / updateStayPackage / deleteStayPackage

Pricing package CRUD — sellPrice is always server-computed, never directly settable

getCurrencyOptions / getBusinessModelOptions

Reference lookups for package currency and business model

getMyStayOrganisationalData / updateStayOrganisationalData

Address, check-in/out policy, cancellation policy, pets/children/parking rules

getStayTypeOptions / getCountryOptions / getCancellationPolicyOptions / getAdditionalInformationOptions

Reference lookups for organisational-data fields

getMyStayContacts / updateStayContacts

Public-facing contact details

getMyStayFacilities / updateStayFacilities / getFacilityGroups

Facility checkboxes, grouped exactly as on the admin UI

getMyBusinessProfile / updateHostBusinessProfile

Business profile (excludes personal, bank, and tax fields — never exposed via MCP)

Key rules: boutique Stays (Boutique1–Boutique6 room types) and standard Stays are validated separately — always call getRoomTypeOptions first. Package price tiers are locked to 7/14/21/30 nights and don't all need to be set — a subset (e.g. 1-week-only) is valid. advertisingEndpoint only applies to Advertising-business-model Stays. Personal, bank, and tax details are permanently excluded from every tool.

Setup

1. Prerequisites

  • Node.js 20+

  • Access to a Nomad Stays SQL Server database (hosted on Coolify/Hetzner)

2. Install

git clone https://github.com/nomadstays/nomadstays-mcp-server.git
cd nomadstays-mcp-server
npm install

3. Configure

cp .env.example .env
# Edit .env and set your NOMADSTAYS_DB_CONNECTION string

4. Build

npm run build

5. Run (stdio mode — for Claude Desktop / local MCP clients)

node build/index.js

6. Run (HTTP mode — for hosted / remote deployments)

PORT=8080 node build/index.js

HTTP endpoints:

  • POST /mcp — MCP Streamable HTTP transport

  • GET /health — Health check

  • GET /api/mcp/stats/daily — Daily usage stats

  • GET /api/mcp/stats/tools — Per-tool usage stats

Claude Desktop configuration

Copy claude_desktop_config.example.json, update the path and connection string, then merge into your claude_desktop_config.json:

{
  "mcpServers": {
    "nomadstays": {
      "command": "node",
      "args": ["/path/to/nomadstays-mcp-server/build/index.js"],
      "env": {
        "NOMADSTAYS_DB_CONNECTION": "Server=tcp:..."
      }
    }
  }
}

Deploy

The production Nomad Stays deployment runs its MCP servers as Docker containers on Coolify (self-hosted on Hetzner) rather than Azure App Service. This repo doesn't include a Dockerfile of its own — containerize it with a standard Node.js build (Node 20+, npm run build, run dist/index.js) and deploy to any Docker-capable host, setting NOMADSTAYS_DB_CONNECTION (and PORT/HTTP_PORT for HTTP mode) as environment variables on the target platform.

Tech stack

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Related MCP Servers

  • MCP API Server

    fikri2992
    A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants to make HTTP requests (GET, POST, PUT, DELETE) to external APIs through standardized MCP tools.
    4
    2
    MIT

  • 1Stay Hotel Booking

    STAYKER-COM
    A
    license
    A
    quality
    C
    maintenance
    Hotel booking MCP server — the first transaction-complete hotel booking integration for AI agents. Search 300K+ properties in 140+ countries, get live rates and room details, and generate secure checkout URLs. No payment in the AI conversation — guests complete booking at a hosted checkout page and receive a real hotel confirmation number. Set your own booking fee via Stripe Connect.
    8
    17
    2
    Inno Setup

View all related MCP servers

Related MCP Connectors

  • 1stay

    Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

  • mcp

    MCP server connecting AI agents to non-custodial staking data across 130+ networks.

  • AgniGateway Marketplace

    AI marketplace — flights, tours, activities, transport & more via MCP. No auth required.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nomadstays/nomadstays-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server