# Trip Night Counter is a travel date MCP. AI Agent Connect

> Trip Night Counter handles the math and logic behind travel bookings. It helps your AI client calculate exact nights between check-in and check-out, validates ISO-8601 date formats, and ensures trip sequences make sense for hospitality standards. Instead of manual date math, your agent gets instant, accurate stay summaries.

## Overview
- **Category:** travel
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_jE2wClEAlkWwZHtblHeMU4qEympD8AEBAHmJR202/ai-agent-connect
- **Tags:** travel, dates, hospitality, booking, duration

## Description

You can stop manually counting nights or double-checking date formats when building travel itineraries or booking workflows. This MCP gives your AI client the specific tools needed to handle hospitality-grade date logic. Whether you are building a booking assistant or a travel planner, you can hand off the heavy lifting of date validation and duration calculation to your agent.

When you provide check-in and check-out dates, the MCP calculates the exact number of nights spent at a location. It also acts as a guardrail by checking if a proposed trip is logically possible, preventing errors like check-out dates that occur before check-in dates. It also ensures all date strings follow the ISO-8601 standard, which keeps your data clean and consistent. If you need to present stay information to a user, the MCP can generate a natural language summary of the trip duration. It's a specialized utility designed to keep travel data accurate and logically sound.

## Tools

### calculate_stay_nights
This tool finds the total number of nights a guest stays at a location based on their dates.

### check_stay_validity
This tool checks if a trip is logically possible according to standard hospitality rules.

### get_stay_summary
This tool generates a high-level overview of a trip's duration for use in booking summaries.

### validate_date_format
This tool verifies that a date string follows the required ISO-8601 format.

## Prompt Examples

**Prompt:** 
```
How many nights is a stay from 2024-06-01 to 2024-06-05?
```

**Response:** 
```
The stay is 4 nights.
```

**Prompt:** 
```
Is a trip from 2024-12-25 to 2024-12-24 valid?
```

**Response:** 
```
No, the check-out date must be after the check-in date.
```

**Prompt:** 
```
Give me a summary for a stay from 2024-01-10 to 2024-01-15.
```

**Response:** 
```
5 nights
```

## Capabilities

### Stay Duration Math
Your agent uses this to find the exact number of nights between two dates.

### Date Format Verification
The MCP checks if date strings match the ISO-8601 standard.

### Trip Logic Checks
Your agent uses this to ensure check-out dates don't happen before check-in dates.

### Natural Language Summaries
The MCP converts date ranges into readable stay summaries.

## Use Cases

### Automated Booking Validation
Your agent checks if a user's requested dates are valid before processing a booking.

### Itinerary Construction
The MCP calculates the exact duration of each leg of a trip.

### Data Cleaning
Use the date validation tool to ensure all incoming travel data follows standard formats.

### Customer Summaries
Generate quick stay summaries to show guests how long their trip lasts.

## Benefits

- Eliminates manual errors in night calculations.
- Enforces ISO-8601 date standards for clean data.
- Prevents impossible booking dates through logical validation.
- Generates human-readable stay summaries automatically.

## How It Works

Connecting to this MCP gives your AI client immediate access to travel date tools.

1. Connect your MCP-compatible client to Vinkius.
2. Provide your agent with the Trip Night Counter MCP.
3. Ask your agent to calculate nights or validate a date.
4. The agent executes the specific tool via the MCP.
5. The agent receives the result and uses it in your workflow.

## Frequently Asked Questions

**What does this MCP do?**
It provides tools to calculate stay nights, validate date formats, and check the logical validity of travel dates.

**Which AI clients can use this MCP?**
You can use this with any MCP-compatible client like Claude, Cursor, Windsurf, or VS Code.

**Can it prevent invalid bookings?**
Yes, the check_stay_validity tool ensures that check-out dates are logically after check-in dates.

**Does it support ISO-8601?**
Yes, it includes a specific tool to verify that date strings follow the ISO-8601 format.

**How do I get stay summaries?**
You can use the get_stay_summary tool to get a natural language description of a trip's duration.

**What date format should I use?**
All dates must follow the YYYY-MM-DD format.

**Can I calculate stays with invalid dates?**
No, the `check_stay_validity` tool will identify if a trip is logically impossible, such as when the check-out date is before the check-in date.

**How is a 'night' defined?**
A night is the period between a check-in date and a check-out date. For example, checking in on Monday and checking out on Tuesday is 1 night.