Stay AI API MCP Server

What is Stay AI API MCP Server?

Stay AI API MCP Server is a Model Context Protocol server that enables AI models to interact with the Stay AI property management API through standardized tools and resources. It is designed for developers and AI agents who need to manage properties, bookings, and customers via the Stay AI platform.

How to use Stay AI API MCP Server?

Clone the repository, install dependencies with npm install, set your Stay AI API key in a .env file as STAY_AI_API_KEY=your_api_key_here, and start the server with npm run dev. Test available tools and resources using the MCP Inspector via npm run inspect.

Key features of Stay AI API MCP Server

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

Use cases of Stay AI API MCP Server

• Allow an AI assistant to search for vacation rentals and check availability
• Enable automated booking creation and cancellation workflows
• Integrate property management data into conversational or agentic AI systems

FAQ from Stay AI API MCP Server

What does Stay AI API MCP Server do?

It bridges AI models (via the Model Context Protocol) to the Stay AI property management API, providing tools and resources for property search, booking management, availability checks, pricing, and customer handling.

What are the prerequisites to run the server?

Node.js 16 or higher and a valid Stay AI API key are required.

How do I configure the server?

Create a .env file in the project root and set STAY_AI_API_KEY to your Stay AI API key.

How do I start the server and test it?

Run npm run dev to start the server. Use npm run inspect to open the MCP Inspector web interface for browsing and testing tools.

What tools are available?

Tools include search_properties, get_property_details, create_booking, get_booking, update_booking, cancel_booking, check_availability, calculate_price, create_customer, and get_customer.