NomadStays MCP Server

Name: Nomad Stays
Author: nomadstays

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

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

Tools available

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 NomadStays help centre articles
`getHelpCenterArticle`	Fetch a specific help article by ID
`listHelpCenterCategories`	List all help centre categories

Related MCP server: MCP API Server

Setup

1. Prerequisites

Node.js 20+
Access to a NomadStays Azure SQL database

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 to Azure App Service

An ARM template is included for one-click deployment:

az deployment group create \
  --resource-group your-resource-group \
  --template-file azure-deploy.json \
  --parameters dbConnectionString="your-connection-string"

Tech stack

TypeScript + Node.js 20
@modelcontextprotocol/sdk
Express (HTTP mode)
mssql (Azure SQL connectivity)

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Nomad Stays