HotelPlanet MCP Server

This is a Model Context Protocol (MCP) server that exposes HotelPlanet API operations as AI agent tools. It can be used with n8n's MCP Client node to make your hotel booking operations available to the AI agent.

What is MCP?

Model Context Protocol (MCP) is a standard for AI agents to interact with external tools and data sources. By creating an MCP server, you can make your HotelPlanet API available as tools that AI agents can discover and use.

Installation

1. Install Dependencies

npm install

2. Build the Server

npm run build

3. Install Globally (Optional)

npm install -g .

Usage with n8n

Step 1: Enable AI Agent Tool Usage

Set the environment variable in your n8n instance:

export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

Step 2: Install MCP Client Node

Install the n8n MCP Client node:

npm install -g n8n-nodes-mcp

Step 3: Configure MCP Client

In your n8n workflow:

1. Add MCP Client node
2. Configure the server:

   {
     "command": "node",
     "args": ["/path/to/mcp-server-hotelplanet/dist/index.js"],
     "env": {
       "HOTELPLANET_API_URL": "http://localhost:3000"
     }
   }

Step 4: Use with AI Agent

Now your HotelPlanet tools will be available to n8n's AI agent!

Available Tools

The MCP server exposes these tools:

Hotel Search

• get_hotels_by_location - Search by country/city with filters
• search_hotels - Search by query string

Hotel Information

• get_hotel_details - Get detailed hotel information

Booking Operations

• check_hotel_availability - Check availability for dates/guests
• book_hotel - Book rooms with guest information

Booking Management

• get_booking_details - Get specific booking information
• cancel_booking - Cancel existing bookings
• get_user_bookings - Get all bookings for a user

Example AI Prompts

With this MCP server, the AI agent can now handle requests like:

• "Find hotels in New York with 4+ star rating under $200/night"
• "Check if the Grand Hotel has availability for 2 guests from Jan 15-18"
• "Book a room at hotel-123 for John Doe from Jan 15-18"
• "Show me all bookings for [email protected]"
• "Cancel booking ABC123"

Configuration

Environment Variables

• HOTELPLANET_API_URL - Base URL of your HotelPlanet API (default: http://localhost:3000)

API Requirements

Your HotelPlanet API must be running and accessible at the configured URL.

Development

Build

npm run build

Watch Mode

npm run dev

Test

npm start

Troubleshooting

MCP Server Not Starting

1. Check that all dependencies are installed
2. Verify TypeScript compilation succeeded
3. Ensure the HotelPlanet API is running

AI Agent Not Finding Tools

1. Verify N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true is set
2. Check MCP Client node configuration
3. Restart n8n after configuration changes

API Connection Issues

1. Verify HOTELPLANET_API_URL is correct
2. Check that your HotelPlanet API is running
3. Test API endpoints manually

Integration with Your HotelPlanet Node

This MCP server works alongside your existing HotelPlanet n8n node:

• Manual workflows: Use your HotelPlanet node
• AI agent workflows: Use MCP Client node with this server
• Both approaches: Use the same underlying API

Benefits

1. AI Agent Integration: Your hotel operations are now available to AI agents
2. Standard Protocol: Uses the official MCP standard
3. Flexible: Can be used with any MCP-compatible AI system
4. Maintainable: Clean separation between API and AI integration

Next Steps

1. Deploy your HotelPlanet API to production
2. Update the MCP server with production API URL
3. Test AI agent integration in n8n
4. Create AI-powered workflows for hotel booking automation

Your HotelPlanet operations are now AI agent ready! 🏨✨