Campertunity MCP Server for Camping Data

Overview

The Campertunity MCP Server exposes camping and outdoor recreation data via the Model Context Protocol (MCP). It runs as a local or remotely launched MCP server so AI models and agent frameworks can call structured “tools” to search campgrounds, inspect place details, check availability, and initiate bookings. The server translates MCP tool calls into Campertunity API requests and returns standardized JSON responses suitable for model consumption.

This server is useful when you want an AI assistant to perform real-time campground research, plan trips around dates and party size, or integrate campground availability into automated workflows. It is intended to be run alongside an MCP-capable model runtime so the model can discover and call its tools rather than relying on scraped or cached data.

Features

• Implements MCP (Model Context Protocol) tool endpoints for camping data
• Search campgrounds by location, radius, date range, party size, tags, and free-text descriptions
• Retrieve detailed place metadata and amenities
• Check site-level availability for specific dates and site IDs
• Initiate bookings through the Campertunity API
• Configurable via environment variable (CAMPERTUNITY_API_KEY)
• Returns real-time, non-cached data suitable for AI tooling

Installation / Configuration

Prerequisites:

• Node.js (for running via npx) or install from the GitHub repo
• Campertunity MCP API key (get one at https://campertunity.com/mcp)

Set your API key as an environment variable:

# macOS / Linux
export CAMPERTUNITY_API_KEY="your_api_key_here"

# Windows PowerShell
$env:CAMPERTUNITY_API_KEY="your_api_key_here"

Run the MCP server locally with npx:

npx -y campertunity-mcp-server@latest

Or include the server in an MCP client config (example for MCP-capable runtimes that launch helper servers):

{
  "mcpServers": {
    "campground-search-mcp-server": {
      "command": "npx",
      "args": ["-y", "campertunity-mcp-server@latest"],
      "env": {
        "CAMPERTUNITY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Repository: https://github.com/campertunity/mcp-server

Available Tools / Resources

The server exposes these primary MCP tools. Each tool accepts JSON parameters and returns JSON responses suitable for model use.

• place-search
  • Searches for places that match location, date, party size, tags, and natural language descriptions.
  • Parameters:
    • limit (integer, default 50, max 1000)
    • startDate (YYYY-MM-DD)
    • endDate (YYYY-MM-DD)
    • adults (integer, default 1)
    • children (integer, default 0)
    • latitude (float)
    • longitude (float)
    • radius (km, default 20)
    • filters (array of tag strings)
    • campgroundDescription (free-text preferences)
• place-details
  • Returns full metadata for a single place.
  • Parameters:
    • placeId (string)
• place-availability
  • Checks availability for sites at a place over a date range.
  • Parameters:
    • placeId (string)
    • siteIds (optional array of site IDs)
    • startDate (YYYY-MM-DD)
    • endDate (YYYY-MM-DD)
• place-book
  • Initiates a booking (subject to provider rules).
  • Parameters:
    • placeId (string)
    • startDate (YYYY-MM-DD)
    • endDate (YYYY-MM-DD)
    • adults (integer, default 1)
    • children (integer, default 0)

Example place-search request payload:

{
  "limit": 20,
  "startDate": "2026-06-10",
  "endDate": "2026-06-12",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "radius": 50,
  "filters": ["tent", "hiking", "toilets"],
  "campgroundDescription": "Shaded tent sites with nearby trails and potable water"
}

Tags for Filtering

Tags are grouped by category. Use these in the filters array to narrow results.

Use Cases

• Trip planning assistant: Ask a model to find tent campsites within 50 km of a city for a weekend, filter for showers and nearby trails, and return places with availability for your dates.
  • The model calls place-search with location, dates, tags, and then place-availability for shortlisted places.
• Dynamic booking workflow: An agent compiles availability, confirms options with the user, then executes place-book to reserve a site programmatically.
• Availability monitoring: Use automated agents to query place-availability for target dates and notify users when desired sites open up.
• Context-aware recommendations: A model uses place-details to surface amenities (e.g., potable water, pet policy) and matches them against user constraints (RV hookups, pet friendly).

Important Notice about Data Use

The Campertunity MCP Server provides aggregated and AI-enhanced data from multiple sources. To respect data licensing and ensure freshness:

• Do not redistribute or publicly cache the raw data
• Do not store or modify data returned by the server; request real-time data for each session
• Use data only within the intended AI assistant or integration workflows

For full terms and to obtain an API key, visit https://campertunity.com/mcp

Troubleshooting & Support

• If the server fails to start, confirm CAMPERTUNITY_API_KEY is set and valid.
• For issues, see the GitHub repository issues page: https://github.com/campertunity/mcp-server
• Ensure your MCP runtime can discover and launch helper servers configured in your MCP client settings.