LumbreTravel

The LumbreTravel MCP Server lets you access the LumbreTravel API through MCP clients like Claude Desktop. It exposes a set of programmable tools for managing programs, activities, passengers, agencies, hotels, services, providers, leaders, vehicles, includes, and seasons, so you can automate travel workflows directly from your MCP client.

How to use

Connect to the LumbreTravel MCP Server from your MCP client by configuring an MCP server entry that runs the server process locally. You can use either a local node process or an npx-based wrapper. Once connected, you can invoke any of the Tools exposed by the server to manage programs, activities, passengers, agencies, hotels, services, and more. The server handles authentication with your LumbreTravel credentials and exposes a wide set of operations such as creating programs, adding activities, or querying passengers.

How to install

Prerequisites: You need Node.js installed on your machine and your LumbreTravel API credentials (Client ID and Client Secret). Prepare these credentials before starting.

# Prerequisites check
node -v
npm -v

# Ensure you have your LumbreTravel credentials ready
# Then choose one of the installation paths below
```} ,{

Option A: Install via Smithery (recommended for Claude Desktop users)

npx -y @smithery/cli install @lumile/lumbretravel-mcp --client claude

Option B: NPX configuration (recommended for quick setup)

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lumbretravel-mcp"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "EMAIL": "<YOUR_EMAIL>",
        "PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

Option C: Local installation (build and run manually)

# Step 1: Clone the repository
git clone <repo-url>
cd lumbretravel-mcp

# Step 2: Install dependencies
npm install

# Step 3: Build the server
npm run build

# Step 4: Start using a Claude Desktop config
# Replace /path/to/lumbretravel-mcp/dist/index.js with the actual path after build

If you choose the local installation method, add this configuration to your Claude Desktop config to run the server via Node.js

{
  "mcpServers": {
    "lumbretravel-mcp": {
      "command": "node",
      "args": [
        "/path/to/lumbretravel-mcp/dist/index.js"
      ],
      "env": {
        "CLIENT_ID": "<YOUR_CLIENT_ID>",
        "CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "EMAIL": "<YOUR_EMAIL>",
        "PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

Additional notes

Debugging MCP servers happens over stdio. If you run into issues, consider using debugging tooling that attaches to the standard input/output streams and check that all environment variables are correctly provided.

Security and maintenance

Keep your credentials secure. Do not commit CLIENT_ID, CLIENT_SECRET, or passwords into version control. Use environment variable management practices and rotate credentials as needed.

Troubleshooting

If the server fails to start, verify that the environment variables are present in the process environment and that the path to the built index.js is correct. Check that the required Node.js version is installed and that dependencies are installed with npm install.

Available tools

create_program

Create a new travel program in LumbreTravel

update_program

Update details of an existing program

delete_program

Delete a program

reactivate_program

Reactivate a previously disabled program

add_activities

Add activities to a program

update_activities

Update activities of a program

delete_activities

Delete activities from a program

get_passengers_by_fullname

Search passengers by full name

get_passengers_by_email

Search passengers by email address

create_bulk_passengers

Create multiple passengers in a single operation

create_passengers

Create one or more passengers

update_passengers

Update passenger details

delete_passengers

Delete a passenger

reactivate_passenger

Reactivate a previously disabled passenger

add_passengers_to_program

Add passengers to a program

get_agencies

Retrieve agencies

get_agency_by_name

Find an agency by name

create_agency

Create a new agency

update_agency

Update an agency

delete_agency

Delete an agency

reactivate_agency

Reactivate an agency

create_hotel

Create a hotel

update_hotel

Update a hotel

delete_hotel

Delete a hotel

reactivate_hotel

Reactivate a hotel

get_hotel_by_name

Get a hotel by name

get_hotels

Get a list of hotels

create_service

Create a service

update_service

Update a service

delete_service

Delete a service

reactivate_service

Reactivate a service

get_services_by_name

Get a service by name

create_service_language

Create a service language

update_service_language

Update a service language

delete_service_language

Delete a service language

reactivate_service_language

Reactivate a service language

get_service_language_by_name

Get a service language by name

get_service_languages

Get service languages

create_provider

Create a provider

update_provider

Update a provider

delete_provider

Delete a provider

reactivate_provider

Reactivate a provider

get_provider_by_name

Get a provider by name

get_providers

Get providers

create_leader

Create a leader

update_leader

Update a leader

delete_leader

Delete a leader

reactivate_leader

Reactivate a leader

get_leaders

Get leaders

create_vehicle

Create a vehicle

update_vehicle

Update a vehicle

delete_vehicle

Delete a vehicle

reactivate_vehicle

Reactivate a vehicle

get_vehicles

Get vehicles

create_include

Create an include

update_include

Update an include

delete_include

Delete an include

reactivate_include

Reactivate an include

get_includes

Get includes

get_season_summary

Get a season summary