Stayai-mcp-server

Stayai-mcp-server

3.1

If you are the rightful owner of Stayai-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Model Context Protocol (MCP) server for the Stay AI property management API. It allows AI models to interact with the Stay AI API through standardized tools and resources.

Stay AI API MCP Server

This is a Model Context Protocol (MCP) server for the Stay AI property management API. It allows AI models to interact with the Stay AI API through standardized tools and resources.

## Features

- Search for properties with various filters
- Get detailed property information
- Create, retrieve, update, and cancel bookings
- Check property availability
- Calculate pricing for stays
- Manage customer profiles

## Getting Started

### Prerequisites

- Node.js 16 or higher
- A Stay AI API key

### Installation

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Create a `.env` file with your Stay AI API key:
   ```
   STAY_AI_API_KEY=your_api_key_here
   ```

### Running the Server

Start the server:
```
npm run dev
```

### Testing with MCP Inspector

Test the server with the MCP Inspector:
```
npm run inspect
```

This will open a web interface where you can:
- Browse available tools and resources
- Test tools with different inputs
- View server logs and responses

## Available Tools

- `search_properties`: Search for properties with various filters
- `get_property_details`: Get detailed information about a specific property
- `create_booking`: Create a new booking for a property
- `get_booking`: Get details of a specific booking
- `update_booking`: Update an existing booking
- `cancel_booking`: Cancel an existing booking
- `check_availability`: Check if a property is available for specific dates
- `calculate_price`: Calculate the price for a stay
- `create_customer`: Create a new customer profile
- `get_customer`: Get details of a specific customer

## Available Resources

- `property://{id}`: Get detailed information about a property
- `booking://{id}`: Get detailed information about a booking

## License

MIT