Koskamo

VailVacay Connector MCP

Provides AI assistants with read-only, structured access to the VailVacay directory of local businesses, hotels, and activities in Vail, Colorado, including live tour listings from Viator.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

VailVacay Connector MCP logo, by Cloudalien Technologies LLCCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Cloudalien Technologies LLC
MCP endpoint (Streamable HTTP)
https://vailvacay-connector.michael-b38.workers.dev/mcp
Vendor documentation

What its tools do

5 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (5)

5 of 5 have a description · 5 of 5 declare behavior hints · 0 of 3 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search and filter local businesses by keyword, category, area, price, and amenities
  • Retrieve full listing details including address, hours, and photos
  • Find bookable tours and activities with live prices and ratings
  • Get hotel booking links pre-set to specific user dates

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.cloudalien2025/vailvacay-directory@1.0.0

Protocol and capabilities

Server
vailvacay-connector 2.2.1
MCP protocol negotiated in check
2025-06-18
Tools
5 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

VailVacay connector, operated by Cloudalien Technologies LLC. Read-only access to the VailVacay directory of Vail, Colorado businesses and to live Viator tour listings. search_listings searches and filters listings (filter values come from list_filters and list_categories); get_listing returns full details for one listing; search_tours returns Viator tours with live starting prices. No tool books, pays or changes anything. Booking links lead to the named provider, which confirms price and availability; links with affiliate:true are affiliate links. Each listing includes its source page url.

Tools

5 advertised

search_listings — Search VailVacay listings
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search VailVacay's curated directory of Vail, Colorado businesses (hotels and lodging, restaurants, bars and après-ski, activities, ski shops, shopping, services and spas). Read-only. Filters: keyword, category, area/neighborhood, price tier, amenities (e.g. ski_in_ski_out, walk_to_lifts, hot_tub, pool, pet_friendly), tag, and distance from a lat/lng or from another listing. Returns compact plain-text listings (description shortened; use get_listing for the full text, hours and FAQ) with the listing page URL, address, phone, website, up to 2 credited photos, and booking links. Booking links are the path to book with the named provider (Expedia for hotels, plus Viator/Klook where the listing has one), not ads; those marked affiliate:true are affiliate links, and VailVacay may earn a commission if the user books, at no extra cost to them. Results are not ranked by commission. Pass check_in/check_out to get date-specific Expedia hotel links (live rates are shown on Expedia, not in this result).

search_listings input schema
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Keywords, e.g. 'steak', 'ski rental', 'hot tub condo'"
    },
    "tag": {
      "type": "string",
      "description": "Exact listing tag, see list_filters"
    },
    "area": {
      "type": "string",
      "description": "Area/neighborhood, e.g. 'Vail Village', 'Lionshead', 'Golden Peak', 'Cascade Village'. See list_filters."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "sort": {
      "enum": [
        "relevance",
        "distance",
        "name"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "adults": {
      "type": "integer",
      "default": 2,
      "maximum": 14,
      "minimum": 1
    },
    "category": {
      "type": "string",
      "description": "Category name or id from list_categories, e.g. 'Hotels'"
    },
    "check_in": {
      "type": "string",
      "description": "YYYY-MM-DD (hotels)"
    },
    "near_lat": {
      "type": "number"
    },
    "near_lng": {
      "type": "number"
    },
    "amenities": {
      "type": "array",
      "items": {
        "enum": [
          "ski_in_ski_out",
          "walk_to_lifts",
          "pool",
          "hot_tub",
          "spa",
          "fitness_center",
          "pet_friendly",
          "parking",
          "shuttle",
          "family_friendly",
          "breakfast",
          "kitchen",
          "rooftop",
          "river_view",
          "outdoor_seating",
          "apres_ski",
          "live_music",
          "free_entry",
          "michelin",
          "wheelchair_accessible"
        ],
        "type": "string"
      },
      "description": "All must match"
    },
    "check_out": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "radius_km": {
      "type": "number",
      "description": "Max distance (km) when near_* is set"
    },
    "price_tier": {
      "enum": [
        "budget",
        "moderate",
        "upscale",
        "luxury"
      ],
      "type": "string"
    },
    "near_listing_id": {
      "type": "string",
      "description": "Rank by distance from this listing"
    },
    "has_booking_link": {
      "type": "boolean",
      "description": "Only listings with a booking link"
    }
  },
  "additionalProperties": false
}
search_listings output schema
{
  "type": "object",
  "required": [
    "status",
    "total",
    "listings"
  ],
  "properties": {
    "page": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    },
    "status": {
      "type": "string"
    },
    "has_more": {
      "type": "boolean"
    },
    "listings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "lat": {
            "type": [
              "number",
              "null"
            ]
          },
          "lon": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Listing page on vailvacay.com"
          },
          "area": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "photos": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "booking": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                },
                "affiliate": {
                  "type": "boolean"
                }
              }
            }
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ]
          },
          "amenities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "price_tier": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": "string",
            "description": "Plain text"
          },
          "distance_km": {
            "type": "number"
          },
          "booking_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "First affiliate booking link, if any"
          },
          "photo_details": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "credit": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "caption": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "per_page": {
      "type": "integer"
    },
    "returned": {
      "type": "integer"
    },
    "data_fetched_at": {
      "type": "string"
    },
    "affiliate_disclosure": {
      "type": "string"
    }
  }
}
search_listings annotations
{
  "title": "Search VailVacay listings",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_listing — Get a VailVacay listing
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read-only. Full details for one VailVacay listing by id: complete plain-text description, FAQ, hours, up to 10 gallery photos with captions and credits (e.g. 'Photo via Expedia'), listing page URL, and booking links (the path to book with the named provider, not ads). Links marked affiliate:true are affiliate links; VailVacay may earn a commission at no extra cost to the user. Returns NOT_FOUND for an unknown id.

get_listing input schema
{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing id from search_listings"
    },
    "adults": {
      "type": "integer",
      "maximum": 14,
      "minimum": 1
    },
    "check_in": {
      "type": "string"
    },
    "check_out": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_listing output schema
{
  "type": "object",
  "required": [
    "status",
    "listing"
  ],
  "properties": {
    "status": {
      "type": "string"
    },
    "listing": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "lon": {
          "type": [
            "number",
            "null"
          ]
        },
        "url": {
          "type": [
            "string",
            "null"
          ],
          "description": "Listing page on vailvacay.com"
        },
        "area": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "phone": {
          "type": [
            "string",
            "null"
          ]
        },
        "photos": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "address": {
          "type": [
            "string",
            "null"
          ]
        },
        "booking": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "provider": {
                "type": "string"
              },
              "affiliate": {
                "type": "boolean"
              }
            }
          }
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "category": {
          "type": [
            "string",
            "null"
          ]
        },
        "amenities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "price_tier": {
          "type": [
            "string",
            "null"
          ]
        },
        "description": {
          "type": "string",
          "description": "Plain text"
        },
        "distance_km": {
          "type": "number"
        },
        "booking_link": {
          "type": [
            "string",
            "null"
          ],
          "description": "First affiliate booking link, if any"
        },
        "photo_details": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string"
              },
              "credit": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "caption": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "affiliate_disclosure": {
      "type": "string"
    }
  }
}
get_listing annotations
{
  "title": "Get listing details",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_categories — List VailVacay categories
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read-only. List the VailVacay directory's top-level categories with listing counts.

list_categories input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_categories output schema
{
  "type": "object",
  "required": [
    "status",
    "categories"
  ],
  "properties": {
    "total": {
      "type": "integer"
    },
    "status": {
      "type": "string"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Category id; null for categories that exist only as listing group names (filter by name instead)"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "listing_count": {
            "type": "integer"
          }
        }
      }
    }
  }
}
list_categories annotations
{
  "title": "List categories",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_filters — List search filters
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read-only. Values usable in search_listings: areas/neighborhoods, price tiers, amenities and tags, each with listing counts, plus notes on how each is derived.

list_filters input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_filters output schema
{
  "type": "object",
  "required": [
    "status"
  ],
  "properties": {
    "tags": {
      "type": "array"
    },
    "areas": {
      "type": "array"
    },
    "status": {
      "type": "string"
    },
    "amenities": {
      "type": "array"
    },
    "price_tiers": {
      "type": "array"
    }
  }
}
list_filters annotations
{
  "title": "List filters",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_tours — Search Vail, Colorado tours and activities (Viator)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Read-only. Live search of bookable tours and activities in Vail, Colorado from Viator's partner API. Returns title, live starting ('from') price and currency, rating, review count, duration, free-cancellation flag, image and a booking_url. Optional start_date/end_date return only products Viator lists as available on those dates. Default order: keyword relevance when q is given, otherwise traveler rating; 'featured' uses Viator's own default order. booking_url is the Viator booking page and a Viator affiliate link: VailVacay may earn a commission if the user books, at no extra cost to them. Viator confirms the final price, availability and cancellation terms before payment.

search_tours input schema
{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Keywords, e.g. 'jeep tour', 'fly fishing', 'mountain bike'"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "sort": {
      "enum": [
        "relevance",
        "rating",
        "price_low",
        "price_high",
        "featured"
      ],
      "type": "string",
      "description": "Default: relevance to q when q is given (Viator keyword match), otherwise rating (highest traveler rating first). featured = Viator's own default order."
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1
    },
    "currency": {
      "enum": [
        "USD",
        "EUR",
        "GBP",
        "CAD",
        "AUD",
        "THB"
      ],
      "type": "string",
      "default": "USD"
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "max_price": {
      "type": "number"
    },
    "min_rating": {
      "type": "number",
      "maximum": 5,
      "minimum": 0
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "free_cancellation": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
search_tours output schema
{
  "type": "object",
  "required": [
    "status",
    "tours"
  ],
  "properties": {
    "total": {
      "type": "integer"
    },
    "tours": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "affiliate": {
            "type": "boolean"
          },
          "from_price": {
            "type": "number"
          },
          "booking_url": {
            "type": "string"
          },
          "product_code": {
            "type": "string"
          },
          "review_count": {
            "type": "integer"
          }
        }
      }
    },
    "status": {
      "type": "string"
    },
    "prices_checked_at": {
      "type": "string"
    },
    "affiliate_disclosure": {
      "type": "string"
    }
  }
}
search_tours annotations
{
  "title": "Search tours (Viator)",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
370 ms
95th percentile latency
370 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 370 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http vailvacay-connector-mcp https://vailvacay-connector.michael-b38.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add vailvacay-connector-mcp --url https://vailvacay-connector.michael-b38.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable vailvacay-connector-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "vailvacay-connector-mcp": {
      "url": "https://vailvacay-connector.michael-b38.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "vailvacay-connector-mcp": {
      "type": "streamableHttp",
      "url": "https://vailvacay-connector.michael-b38.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start vailvacay-connector-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "vailvacay-connector-mcp": {
      "type": "http",
      "url": "https://vailvacay-connector.michael-b38.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http vailvacay-connector-mcp https://vailvacay-connector.michael-b38.workers.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://vailvacay-connector.michael-b38.workers.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "vailvacay-connector-mcp": {
      "serverUrl": "https://vailvacay-connector.michael-b38.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like VailVacay Connector MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,475