mcpField
D
DirectStay MCP Server

DirectStay MCP Server

Local
github.com/webdevtodayjasonMaps & Travel0Updated 74w ago
Repository

About DirectStay MCP Server

DirectStay MCP Server exposes DirectStay API operations for properties, bookings, and messaging as MCP tools. It is intended for integrations using the API and also supports OTP operations, property comparisons, and conversation insight submission.

Key features

  1. 01List properties and retrieve details
  2. 02Retrieve property bookings
  3. 03Create bookings and update statuses
  4. 04Identify callers and verify OTPs
  5. 05Send messages and compare properties
  6. 06Submit conversation insights

Use cases

  1. 01Look up DirectStay properties and bookings
  2. 02Create or update property bookings
  3. 03Verify callers with OTP

MCP support

It exposes tools for calling the DirectStay API to MCP clients and requires a DirectStay API token.

#mcp-server#directstay-api#server-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ds": {
      "command": "npx",
      "args": [
        "-y",
        "@webdevtoday/ds-mcp-server"
      ]
    }
  }
}
Run commandnpx -y @webdevtoday/ds-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@webdevtoday/ds-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

DirectStay MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the DirectStay API.

Installation

You can run this MCP server using npx without installing it locally:

npx @webdevtoday/ds-mcp-server

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "directstay": {
      "command": "npx",
      "args": ["-y", "@webdevtoday/ds-mcp-server"],
      "env": {
        "DS_TOKEN": "your_directstay_api_token_here"
      }
    }
  }
}

To find your Claude Desktop configuration:

  1. Open Claude Desktop
  2. Go to Settings → Developer → Edit Config

Available Tools

This MCP server provides the following tools for interacting with the DirectStay API:

  • get_all_properties - Get a list of all properties
  • get_property_by_id - Get details of a specific property
  • get_property_bookings - Get all bookings for a specific property
  • create_booking - Create a new booking
  • update_booking_status - Update the status of an existing booking
  • identify_caller - Identify a caller based on phone number
  • generate_otp - Generate a one-time password
  • verify_otp - Verify a one-time password
  • send_message - Send a message to a user
  • create_comparison - Create a property comparison
  • submit_conversation_insights - Submit conversation insights

To see detailed information about all available tools and their parameters:

npx @webdevtoday/ds-mcp-server tools

Getting Your DirectStay API Token

To use this MCP server, you'll need a DirectStay API token. Contact DirectStay to obtain your API credentials.

Development

Prerequisites
  • Node.js (v16+ required, v20+ recommended)
  • npm
Local Setup
  1. Clone the repository
  2. Install dependencies: 
    npm install
  3. Create a .env file with your API token: 
    DS_TOKEN=your_directstay_api_token_here
  4. Run the server: 
    node mcpServer.js
Running with SSE (Server-Sent Events)
node mcpServer.js --sse
Docker Support

Build and run with Docker:

docker build -t ds-mcp-server .
docker run -i --rm -e DS_TOKEN=your_token_here ds-mcp-server

License

MIT

Support

For issues or questions about this MCP server, please open an issue on GitHub.

For DirectStay API support, contact DirectStay directly.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.