mcp

This MCP server implements the Campertunity MCP and exposes tools to search for camping places, retrieve place details, check availability, and book sites. It provides a structured interface for AI models to query real-time camping data, filtering by location, dates, and preferences, and then perform actions such as reserving a site. The available tools are place-search for finding camping options with filters, place-details for in-depth information on a chosen campground, place-availability to check site availability over a date range, and place-book to complete a booking. To use it, ensure you have an API key for Campertunity and pass it via the CAMPERTUNITY_API_KEY environment variable when starting the server. The tools accept common parameters like location coordinates, date ranges, party size, and a rich set of filters (site types, amenities, terrain, and activities) to tailor results to your needs.

Prerequisites:

• Node.js and npm installed on your machine
• Access to a Campertunity API key (CAMPERTUNITY_API_KEY)

Installation steps:

1. Ensure Node.js and npm are installed. You can verify with: node -v npm -v

2. Obtain your Campertunity API key from the Campertunity MCP page.

3. Run the MCP server using npx (no local installation required): CAMPERTUNITY_API_KEY=your_api_key_here npx -y campertunity-mcp-server@latest

4. (Optional) If you want to pin a specific version, replace latest with a version tag, e.g., campertunity-mcp-server@1.0.0.

5. In your MCP client config, reference the server as shown in the example: { "mcpServers": { "campground-search-mcp-server": { "command": "npx", "args": ["-y", "campertunity-mcp-server@latest"], "env": { "CAMPERTUNITY_API_KEY": "your_api_key_here" } } } }

Tips and considerations:

• Do not share your CAMPERTUNITY_API_KEY publicly; keep it in environment variables or secret management.
• The server relies on real-time data from Campertunity sources; avoid caching responses locally.
• If you encounter API rate limits or authentication errors, verify your API key and ensure it has active permissions for MCP access.
• The tool parameters support defaults (e.g., limit, startDate, endDate). Explicitly set them for reproducible results.
• When integrating with an AI model, use place-search to obtain candidates, then fetch place-details and check place-availability before attempting booking with place-book.