Mcp Server

What is Mcp Server about?

Mcp Server delivers a set of Model Context Protocol (MCP) tools that let AI agents query and act on camping place data. It supports searching for campsites, retrieving detailed information, checking site availability, and making reservations directly through the server.

How to use Mcp Server?

1. Obtain an API key from https://campertunity.com/mcp.
2. Set the environment variable CAMPERTUNITY_API_KEY with your key.
3. Install the server via npx -y campertunity-mcp-server@latest (or include the provided client configuration).
4. Invoke the exposed tools (place-search, place-details, place-availability, place-book) from your MCP‑compatible AI model, passing the required parameters as defined in the README.

Key features of Mcp Server

• place-search: Filter campsites by location, dates, guest count, radius, tags, and natural‑language descriptions.
• place-details: Retrieve comprehensive data for a specific campsite.
• place-availability: Check real‑time availability for sites or specific site IDs over a date range.
• place-book: Create a reservation for a campsite with guest and date information.
• Rich tag system covering site types, access methods, activities, amenities, and terrain.
• Enforced real‑time data usage; no caching or redistribution.

Use cases of Mcp Server

• Travel assistants: AI chatbots can find and book campsites for users on the fly.
• Trip planning apps: Integrate search and booking capabilities without building a custom backend.
• Outdoor activity recommendation engines: Suggest locations based on desired activities and amenities.
• Availability monitoring: Continuously check opening slots for popular sites and alert users.

FAQ from the Mcp Server

Q: Do I need to run a separate server? A: No, the server is a lightweight npm package that can be launched with npx and communicates via MCP.

Q: Which environment variable holds my key? A: CAMPERTUNITY_API_KEY.

Q: Can I cache the data for faster responses? A: Data must be fetched in real time; caching or redistribution is prohibited.

Q: What date format is required? A: YYYY-MM-DD.

Q: What is the maximum number of results for a search? A: Up to 1,000 results (default 50).

MCP Server for Campertunity

This server implements the Model Context Protocol (MCP) for Campertunity, providing AI models with tools to interact with camping and outdoor recreation data.

MCP Client Config

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

Setup

1. Get your API key from https://campertunity.com/mcp
2. Set the environment variable:

   CAMPERTUNITY_API_KEY=your_api_key_here
   

Available Tools

place-search

Search for camping places with various filters and criteria.

• Parameters:
  • limit: Number of results (default: 50, max: 1000)
  • startDate: Start date for availability (YYYY-MM-DD)
  • endDate: End date for availability (YYYY-MM-DD)
  • adults: Number of adults (default: 1)
  • children: Number of children (default: 0)
  • latitude: Center point latitude
  • longitude: Center point longitude
  • radius: Search radius in kilometers (default: 20)
  • filters: Array of tags to filter by (see Tag enum below)
  • campgroundDescription: Natural language description of desired campground features

place-details

Get detailed information about a specific camping place.

• Parameters:
  • placeId: ID of the place to get details for

place-availability

Check availability of camping sites at a specific place.

• Parameters:
  • placeId: ID of the place to check
  • siteIds: Optional array of specific site IDs to check
  • startDate: Start date (YYYY-MM-DD)
  • endDate: End date (YYYY-MM-DD)

place-book

Book a camping site.

• Parameters:
  • placeId: ID of the place to book
  • startDate: Start date (YYYY-MM-DD)
  • endDate: End date (YYYY-MM-DD)
  • adults: Number of adults (default: 1)
  • children: Number of children (default: 0)

Available Tags for Filtering

Site Types

• tent
• rv
• lodging
• glamping
• cabin

Access Types

• driveIn
• walkIn
• equestrian
• boat

Activities

• biking
• boating
• fishing
• hiking
• horsebackRiding
• paddling
• windSports
• surfing
• swimming
• whitewaterPaddling
• wildlifeWatching

Amenities

• picnicTable
• fires
• toilets
• outhouse
• potableWater
• petFriendly
• rvHookup
• rvSanitation
• trash
• showers
• wifi
• handicap

Terrain

• beach
• cave
• desert
• forest
• hotSpring
• lake
• river
• swimmingHole
• waterfall
• creek

Important Notice

The data provided through these tools is collected from multiple sources and enhanced with AI. To ensure data accuracy and respect intellectual property rights:

• Do not redistribute the data
• Do not save or cache the data
• Do not modify the data
• Always use real-time data through the server

For more information, visit campertunity.com