Skip to main content
Glama
got-cosy-mcp

got-cosy-mcp

by perwinroth

got-cosy-mcp

An MCP server for Got Cosy, the Feel Layer for hotel data: cosiness scores for about 6,300 independent hotels, computed from guest reviews and photos, with verified booking links. Free and read-only.

This package is a thin stdio proxy. Each tool call is forwarded over standard MCP JSON-RPC to Got Cosy's hosted Streamable HTTP endpoint at https://gotcosy.com/api/mcp and the result is returned unchanged. There are no local secrets, no API key and no local data: this server only needs outbound HTTPS.

If your client speaks Streamable HTTP directly, you can skip this package entirely and point it at https://gotcosy.com/api/mcp (manifest: https://gotcosy.com/mcp.json). Use this stdio proxy for clients that only support stdio-based MCP servers.

Install and run

Using npx (no install step):

npx got-cosy-mcp

Using Docker:

docker build -t got-cosy-mcp .
docker run -i --rm got-cosy-mcp

Add to an MCP client config (example for a client that reads a JSON config of servers):

{
  "mcpServers": {
    "got-cosy": {
      "command": "npx",
      "args": ["-y", "got-cosy-mcp"]
    }
  }
}

Related MCP server: HotelZero

Tools

find_cosy_hotels

Find live, cosy-scored hotels. Only hotels that clear the public floor (score 5.0+) are returned. All arguments are optional.

Argument

Type

Description

city

string

City name, e.g. "Paris"

country

string

Country name, e.g. "France"

min_score

number

Minimum cosy score 0-10 (the public floor of 5.0 always applies)

limit

number

Max results, default 20, max 100

Example call:

{
  "name": "find_cosy_hotels",
  "arguments": { "city": "Paris", "limit": 5 }
}

Example result (truncated):

{
  "hotels": [
    {
      "slug": "les-dames-du-pantheon",
      "name": "Les Dames du Panthéon",
      "city": "Paris",
      "country": "France",
      "cosy_score": 6.7,
      "url": "https://gotcosy.com/en/hotels/les-dames-du-pantheon",
      "verified_booking": "stay22",
      "website": "https://www.hotellesdamesdupantheon.com"
    }
  ],
  "total": 81,
  "limit": 5,
  "offset": 0
}

get_hotel_feeling

Get one hotel's cosy score, evidence signals and description by its Got Cosy slug (as returned by find_cosy_hotels, or from a gotcosy.com/en/hotels/<slug> URL).

Argument

Type

Required

Description

slug

string

yes

The hotel's Got Cosy slug

Hotels below the public floor return {"below_bar": true} with no score exposed.

Data and scoring

Got Cosy scores independent hotels 0-10 for warmth, intimacy and character, drawn from guest reviews and photos rather than star ratings or price. Only hotels that clear a public floor of 5.0 are exposed through these tools. See gotcosy.com for the full index and gotcosy.com/llms-full.txt for machine-readable documentation.

Licence

MIT, see LICENSE.

Available Tools

2 tools
find_cosy_hotelsA

Find live, cosy-scored hotels from Got Cosy's cosiness index (gotcosy.com): hotels scored 0-10 for warmth, intimacy and character from photos and reviews. Only returns hotels that clear the public floor (score 5.0+). Optionally filter by city, country and a minimum cosy score.

Inputs: city, limit, country, min_score.

get_hotel_feelingA

Get one hotel's cosy score, evidence signals and description from Got Cosy, by its slug (as returned in find_cosy_hotels' results, or from a gotcosy.com/en/hotels/ URL). Below-floor hotels return {below_bar:true} with no score exposed.

Inputs: slug (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools serve clearly distinct purposes: one searches for hotels, the other retrieves details for a specific hotel. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tool names follow the verb_noun pattern with snake_case (find_cosy_hotels, get_hotel_feeling). The verbs 'find' and 'get' are semantically appropriate and consistent in style.

    Tool Count3/5

    The server has only 2 tools, which is on the thin end of the scale. However, for a niche service focused on searching and retrieving hotel cosiness scores, this small count is acceptable, though it feels minimal.

    Completeness4/5

    The domain is covered by the core workflow: search for hotels with cosy scores, then get detailed information on a specific hotel. No obvious gaps are present, but the lack of additional query capabilities (e.g., listing all cities) is a minor limitation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers