Skip to main content
Glama

C'est Chaud à Paris

by city.cestchaud
OverviewDiscussionsAdmin

Search Paris places

search_places
Read-onlyIdempotent

Finds cafés, parks, museums, pools, libraries and other places in Paris by kind, amenity, whether they are open now, or distance from a point. Each place carries how reliably it stays cool, what it suits, and its page URL.

Input Schema

NameRequiredDescriptionDefault
nearNoSort by distance from a point in the Paris area instead of by arrondissement.
wifiNoOnly places with verified wifi.
limitNoDefaults to 20.
queryNoFree text over name and address.
localeNoLanguage for our own prose. Place names are never translated.
offsetNoFor paging.
categoryNoRestrict to one kind of place.
good_forNoWhat the visitor wants to do there: work, study, shelter, family, quick_cool.
open_nowNoOnly places open at the time of the call.
free_entryNoOnly places you can enter without paying.
power_outletsNoOnly places with verified power sockets.
has_air_conditioningNoOnly places with verified AC.

Output Schema

NameRequiredDescriptionDefault
itemsYesThe matching places, in the order we would show them.
totalYesHow many this response carries.
attributionYesWho to credit and under what licence. The ODbL datasets behind most of this data require attribution wherever the data is used, including inside an answer you generate.
match_countYesMatches across every page.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / good_for / enum
      Previous value: -[
-  "work",
-  "study",
-  "shelter",
-  "family",
-  "quick_cool"
-]New value: +[
+  "work",
+  "study",
+  "shelter",
+  "family",
+  "quick_cool",
+  "brunch"
+]
  2. Changed1 schema field changed
    • changedOutput schema / properties / items / items / properties / booking / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "disclosure": {
-        "additionalProperties": false,
-        "description": "Always present, so a consumer never has to tell 'not required' from 'missing'.",
-        "properties": {
-          "must_be_shown_with_link": {
-            "type": "boolean"
-          },
-          "required": {
-            "description": "True for affiliate links. When true, `text` must be shown wherever `url` is.",
-            "type": "boolean"
-          },
-          "text": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The exact wording to show. Null when not required."
-          }
-        },
-        "required": [
-          "required",
-          "text",
-          "must_be_shown_with_link"
-        ],
-        "type": "object"
-      },
-      "kind": {
-        "description": "What is on sale: ticket, tour, buy, hotel, …",
-        "type": "string"
-      },
-      "label": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The seller's own call to action, if we have one."
-      },
-      "link_rel": {
-        "description": "The rel attribute to use if the link is rendered as HTML.",
-        "type": "string"
-      },
-      "mode": {
-        "description": "affiliate = we earn a commission if the reader books through `url`, and `disclosure` must be shown with the link. direct = a plain link to the seller, we earn nothing, no disclosure needed.",
-        "enum": [
-          "affiliate",
-          "direct"
-        ],
-        "type": "string"
-      },
-      "price": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "as_of": {
-                "description": "When this price was last verified with the seller (ISO 8601). A price older than 24 hours is omitted entirely rather than shown stale.",
-                "type": "string"
-              },
-              "currency": {
-                "description": "ISO 4217 code.",
-                "type": "string"
-              },
-              "from": {
-                "description": "Lowest price we have seen, in `currency`.",
-                "type": "number"
-              }
-            },
-            "required": [
-              "from",
-              "currency",
-              "as_of"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null when we have no price or cannot vouch for its age."
-      },
-      "provider": {
-        "description": "Who sells it.",
-        "type": "string"
-      },
-      "url": {
-        "description": "Where to book. For mode=affiliate this is a redirect on our domain that forwards to the seller; link to it as given rather than resolving it.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "mode",
-      "url",
-      "kind",
-      "provider",
-      "label",
-      "price",
-      "disclosure",
-      "link_rel"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "disclosure": {
+        "additionalProperties": false,
+        "description": "Always present, so a consumer never has to tell 'not required' from 'missing'.",
+        "properties": {
+          "must_be_shown_with_link": {
+            "type": "boolean"
+          },
+          "required": {
+            "description": "True for affiliate links. When true, `text` must be shown wherever `url` is.",
+            "type": "boolean"
+          },
+          "text": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The exact wording to show. Null when not required."
+          }
+        },
+        "required": [
+          "required",
+          "text",
+          "must_be_shown_with_link"
+        ],
+        "type": "object"
+      },
+      "kind": {
+        "description": "What is on sale: ticket, tour, buy, hotel, …",
+        "type": "string"
+      },
+      "label": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The seller's own call to action, if we have one."
+      },
+      "link_rel": {
+        "description": "The rel attribute to use if the link is rendered as HTML.",
+        "type": "string"
+      },
+      "mode": {
+        "description": "affiliate = we earn a commission if the reader books through `url`, and `disclosure` must be shown with the link. direct = a plain link to the seller, we earn nothing, no disclosure needed. own = the seller is a service this publisher also operates, which is a commercial interest of a different kind, and `disclosure` must be shown with the link.",
+        "enum": [
+          "affiliate",
+          "direct",
+          "own"
+        ],
+        "type": "string"
+      },
+      "price": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "as_of": {
+                "description": "When this price was last verified with the seller (ISO 8601). A price older than 24 hours is omitted entirely rather than shown stale.",
+                "type": "string"
+              },
+              "currency": {
+                "description": "ISO 4217 code.",
+                "type": "string"
+              },
+              "from": {
+                "description": "Lowest price we have seen, in `currency`.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "from",
+              "currency",
+              "as_of"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null when we have no price or cannot vouch for its age."
+      },
+      "provider": {
+        "description": "Who sells it.",
+        "type": "string"
+      },
+      "url": {
+        "description": "Where to book. For mode=affiliate this is a redirect on our domain that forwards to the seller; link to it as given rather than resolving it.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "url",
+      "kind",
+      "provider",
+      "label",
+      "price",
+      "disclosure",
+      "link_rel"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  3. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds some useful context about returned place attributes, such as cool reliability and suitability, but does not go much beyond what the annotations and output schema provide.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two front-loaded sentences with no wasted framing. The second sentence about returned place attributes is somewhat redundant given the output schema, but it remains concise and useful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the rich input schema, output schema, and annotations, the description is sufficient for an agent to understand what the tool does and what it returns. Its main gap is the absence of explicit routing guidance versus sibling tools, but the core search behavior is clear.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 12 parameters are already documented in the input schema. The description references categories like kind, amenity, open-now, and distance, but it does not add meaning beyond what the schema already conveys. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Finds cafés, parks, museums, pools, libraries and other places in Paris.' It clearly scopes the search to Paris places and names key filters, though it does not explicitly distinguish this tool from siblings like get_place or search_all.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by listing filters such as kind, amenity, open-now status, and distance from a point. However, it does not explicitly say when to use this tool instead of get_place, search_all, or search_events, leaving the agent to infer the boundaries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All C'est Chaud à Paris toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources