mcp -airbnb

This MCP server provides an Airbnb search and property detail toolkit packaged as a Desktop Extension (DXT) and exposed via the MCP protocol. The core capabilities are exposed through two tools: airbnb_search and airbnb_listing_details. The airbnb_search tool lets you query listings using location, dates, guest counts, price ranges, and pagination, returning a list of matching properties with pricing and direct listing links. The airbnb_listing_details tool fetches comprehensive information for a specific listing, including location coordinates, amenities, policies, highlights, and a direct link to the listing. By default, the server respects robots.txt, but you can override this in test scenarios using the ignore-robots-txt option when running the server. You can run the MCP server via npx with the provided configuration and then call the tools from your MCP client as you would with other MCP-enabled services.

Prerequisites:

• Node.js 18+ installed on your system (the server runs on Node.js 18+).
• npm (comes with Node.js).

Installation steps:

1. Ensure Node.js is installed. Verify with: node -v npm -v
2. Install or run the MCP server using the published package via npx (no local install required): npx -y @openbnb/mcp-server-airbnb
3. If you prefer to install locally for development, you can clone the repository (if available) and install dependencies: git clone https://github.com/openbnb-org/mcp-server-airbnb.git cd mcp-server-airbnb npm install npm run build # if a build step is defined node dist/index.js # or the appropriate startup script
4. To register the MCP server in your client configuration, add the following to your mcp.json (as shown in the README): { "mcpServers": { "airbnb": { "command": "npx", "args": [ "-y", "@openbnb/mcp-server-airbnb" ] } } }

Tips and common considerations:

• By default, the server adheres to robots.txt. Use the ignore-robots-txt flag for testing or when you explicitly need to bypass robots.txt (not recommended for production).
• The runtime is Node.js 18+, ensure compatibility with your MCP client.
• When using airbnb_search, you can filter by location, optional Google Place ID, date range, guest counts, and price range. Pagination is supported via the cursor parameter.
• When using airbnb_listing_details, you can optionally specify checkin/checkout and guest counts to influence price estimates and availability where supported.
• Monitor request timing and implement rate-limiting considerations in your application to avoid overwhelming Airbnb's servers.
• The server emits structured results including direct listing links for easy navigation.