aitrips.io
Sign inGet started
Back to Home

API Documentation

Connect your AI assistant to aitrips.io using the Model Context Protocol (MCP).

Quick Start

1. Sign up at aitrips.io and go to Settings to generate your API key.

2. Add the MCP server to your AI client configuration:

{
  "mcpServers": {
    "aitrips": {
      "url": "https://www.aitrips.io/api/ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. Ask your AI to create a trip: "Create a 7-day trip to Barcelona starting June 1st with a €2000 budget"

Authentication

All API requests require authentication using your API key. Generate one from your account settings page.

Include the key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP Endpoint

The main API endpoint for all MCP tools:

POST https://www.aitrips.io/api/ai/mcp

Request format:

{
  "tool": "trip_create",
  "arguments": {
    "name": "Paris Vacation",
    "destination": "Paris, France",
    "startDate": "2026-06-01",
    "endDate": "2026-06-07"
  }
}

Available Tools

Trip Management

  • trip_createCreate a new trip with name, destination, dates, budget, and timezone
  • trip_getGet full trip details including items, locations, and collaborators
  • trip_listList all your trips with optional status filter
  • trip_updateUpdate trip details like dates, budget, or status
  • trip_deleteDelete a trip and all associated data

Trip Items

Items can be: ACCOMMODATION, ACTIVITY, FLIGHT, MEAL, or TRANSPORT

  • trip_item_addAdd an item with date, time, location, cost estimate, and notes
  • trip_item_listList items with optional filters for type, date range, or status
  • trip_item_updateUpdate item details, status, or add booking confirmation
  • trip_item_deleteRemove an item from the trip

Locations

  • trip_location_addSave a location with coordinates, address, and notes
  • trip_location_listList saved locations with optional city/country filter
  • trip_location_nearbyFind saved locations within a radius of coordinates
  • trip_location_deleteRemove a saved location

Tasks & Reminders

  • trip_task_createCreate a task with due date, priority, and optional link to a trip item
  • trip_task_listList tasks with optional status filter
  • trip_task_updateUpdate task details or priority
  • trip_task_completeMark a task as completed
  • trip_task_deleteRemove a task

Collaboration & Sharing

  • trip_share_createGenerate a share link with permission level, expiry, and usage limits
  • trip_share_listList all active share links for a trip
  • trip_share_revokeRevoke a share link
  • trip_collaborators_listList all collaborators on a trip
  • trip_collaborators_removeRemove a collaborator from a trip

Itinerary & Search

  • trip_itinerary_getGet a complete day-by-day itinerary for a trip
  • searchSearch across all trips, items, and locations

Example: Create a Trip

curl -X POST https://www.aitrips.io/api/ai/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "trip_create",
    "arguments": {
      "name": "Tokyo Adventure",
      "destination": "Tokyo, Japan",
      "startDate": "2026-09-15",
      "endDate": "2026-09-22",
      "currency": "JPY",
      "budgetTotal": 300000,
      "timezone": "Asia/Tokyo"
    }
  }'

Supported AI Clients

aitrips.io works with any AI client that supports the Model Context Protocol (MCP):

  • Claude Desktop - Native MCP support
  • ChatGPT - MCP support via plugins (requires ChatGPT Plus)
  • Gemini - MCP support via extensions
  • Other clients - Any MCP-compatible application