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

       

       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