# Campsite Night Counter AI Agent Connect

> Campsite Night Counter MCP gives your AI agent the specific math tools needed to manage campground stays. It calculates total campsite-nights, checks if a booking fits within zone limits, and breaks down nightly occupancy for billing. Instead of manual spreadsheets, your AI client handles the occupancy logic directly.

## Overview
- **Category:** logistics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HoKxyMvIN18T0SPd3RxDGlUyJjnyJTTTLbraGzau/ai-agent-connect
- **Tags:** camping, occupancy, billing, scheduling, management

## Description

Managing a campground involves constant math regarding how many sites are filled and for how long. This MCP gives your AI client the ability to act as a logistics coordinator for your site management. You can use it to figure out exactly how many nights a group is staying or to verify if a large group can actually fit into a specific camping zone. It handles the heavy lifting of multiplying stays by site counts to get total occupancy numbers. If you need to prepare for billing, the MCP provides daily breakdowns of how many sites were used over a specific period. It's built to take the guesswork out of occupancy tracking and capacity planning.

## Tools

### get_billing_period_summary
This tool provides a daily breakdown of how many sites were occupied during a specific date range for a single campsite.

### get_stay_duration
Use this to find the exact number of nights a single campsite is occupied during a stay.

### get_total_campsite_nights
This tool calculates the total campsite-nights for a specific group stay by multiplying sites by duration.

### validate_campsite_capacity
This tool checks if a requested number of sites stays within the allowed limits for a specific camping zone.

## Prompt Examples

**Prompt:** 
```
How many campsite-nights are there for 3 campsites from 2024-06-01 to 2024-06-05?
```

**Response:** 
```
There are 12 campsite-nights in total.
```

**Prompt:** 
```
How many nights will a single campsite be occupied from 2024-07-04 to 2024-07-10?
```

**Response:** 
```
The stay duration is 6 nights.
```

**Prompt:** 
```
Can I book 5 campsites in a zone that only has a max capacity of 4?
```

**Response:** 
```
No, the requested 5 campsites exceed the maximum capacity of 4.
```

## Capabilities

### Occupancy Math
Your agent calculates total campsite-nights for any group stay.

### Capacity Validation
The AI checks if requested bookings fit within specific zone limits.

### Stay Duration Tracking
Your client determines the exact number of nights for individual site stays.

### Billing Summaries
The MCP generates daily occupancy breakdowns for specific date ranges.

## Use Cases

### Group Booking Validation
Check if a large group's request fits within the capacity of a specific camping zone.

### Billing Preparation
Get a daily breakdown of occupancy to prepare invoices for stays.

### Occupancy Reporting
Calculate total campsite-nights to understand total site usage over time.

### Stay Duration Checks
Quickly find out how many nights a specific site is booked for.

## Benefits

- Automates the multiplication of sites and stay duration.
- Prevents overbooking by validating zone capacity.
- Generates daily occupancy data for billing periods.

## How It Works

Connect the MCP to your AI client to start running occupancy math.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Ask your AI client to perform a calculation or check capacity.
3. The AI invokes the specific tool needed from the MCP.
4. Your AI client receives the data and gives you the final answer.

## Frequently Asked Questions

**How does this MCP calculate campsite-nights?**
It calculates the total by multiplying the number of sites occupied by the duration of the stay.

**Can I use this to prevent overbooking?**
Yes, you can use the capacity validation tool to check if a requested number of sites exceeds a zone's limit.

**What AI clients can I use with this MCP?**
You can connect this MCP to any compatible client including Claude, Cursor, Windsurf, and VS Code.

**Does this help with billing?**
Yes, it provides a summary of nightly occupancy for a single campsite over a range of dates.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP so it is ready to use immediately after you connect.

**How do I calculate total occupancy for a group?**
You can use the `get_total_campsite_nights` tool by providing the arrival date, departure date, and the number of campsites being used.

**Can I check if a booking fits in a specific zone?**
Yes, use the `validate_campsite_capacity` tool to compare the requested number of sites against the maximum capacity of a zone.

**What happens if the arrival and departure dates are the same?**
The calculation will return zero campsite-nights, as no full nights have elapsed.