Skip to main content
Glama
Sign In

C'est Chaud à Paris

by city.cestchaud
OverviewDiscussionsAdmin

Get one Paris event

get_event
Read-onlyIdempotent

Returns one event by slug: its dates, venue, subject tags, our own description where we have written one, and a booking link where we hold an offer. Use it after search_events, or when you already have an event URL.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "slug": "<slug>"
    },
    "name": "get_event"
  }
}

Input Schema

NameRequiredDescriptionDefault
slugYesThe event's slug — the last path segment of its page URL.
localeNoLanguage for our own prose. The event's title is never translated.

Output Schema

NameRequiredDescriptionDefault
eventYesThe event, with its full date list and venue resolved.
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.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / event / properties / image / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "credit": {
-        "type": "string"
-      },
-      "url": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "url",
-      "credit"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ai_generated": {
+        "description": "True when the picture was generated by a model rather than photographed at the place. ALWAYS present, never null: an agent renders its own interface and no caption of ours reaches its reader, so the disclosure has to be a field (EU AI Act Art. 50(4)) — the same reason `booking.disclosure` is a block and not a sentence.",
+        "type": "boolean"
+      },
+      "credit": {
+        "description": "Attribution. A licence condition on every host we allow — show it with the image.",
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "url",
+      "credit",
+      "ai_generated"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / event / properties / image / description
      Previous value: -"Only images whose licence allows the URL to travel; `credit` must be shown."New value: +"Only images whose licence allows the URL to travel; `credit` must be shown. Event artwork comes from the seller's feed, so `ai_generated` is false unless a feed ever tells us otherwise."
  2. Changed5 schema fields changed
    • addedOutput schema / properties / event / properties / next_bookable_at
      Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The first upcoming performance still on sale. Differs from `starts_at` when the front of a run is gone — that is the date to quote. Null when unknown or nothing is left."
+}
    • addedOutput schema / properties / event / properties / occurrences / items / properties / sold_out
      Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "True = this performance has nothing left to sell. Null = the seller publishes no inventory for it, which is not the same as available."
+}
    • changedOutput schema / properties / event / properties / occurrences / items / required
      Previous value: -[
-  "starts_at",
-  "ends_at"
-]New value: +[
+  "starts_at",
+  "ends_at",
+  "sold_out"
+]
    • addedOutput schema / properties / event / properties / sold_out
      Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "True = nothing left to sell on ANY date; `price` and `booking` describe a show you cannot get into. Null = nobody stated inventory, never read it as available."
+}
    • changedOutput schema / properties / event / required
      Previous value: -[
-  "id",
-  "slug",
-  "title",
-  "url",
-  "format",
-  "kind",
-  "starts_at",
-  "ends_at",
-  "all_day",
-  "occurrences",
-  "venue",
-  "interests",
-  "free",
-  "price",
-  "reservation",
-  "summary",
-  "image",
-  "booking",
-  "updated_at"
-]New value: +[
+  "id",
+  "slug",
+  "title",
+  "url",
+  "format",
+  "kind",
+  "starts_at",
+  "ends_at",
+  "all_day",
+  "occurrences",
+  "sold_out",
+  "next_bookable_at",
+  "venue",
+  "interests",
+  "free",
+  "price",
+  "reservation",
+  "summary",
+  "image",
+  "booking",
+  "updated_at"
+]
  3. Changed1 schema field changed
    • changedOutput schema / properties / event / 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"
+  }
+]
  4. First observed

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive, and closed-world, so the safety profile needs no restating. The description's added value is modest: it flags that the proprietary description and booking link are conditional ('where we have written one', 'where we hold an offer'), which hints at nullable fields, but an output schema exists that already carries this. Nothing about not-found behavior or cost is disclosed.

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

Conciseness5/5

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

Two sentences, zero waste: the first front-loads what is returned, the second front-loads when to reach for it. Nothing repetitive or padding.

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?

With an output schema, full parameter documentation, and rich annotations, the description covers what an agent needs to select and invoke this tool. The one unaddressed case is behavior when the slug does not resolve, which for a lookup-by-identifier tool would be worth a clause.

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 coverage is 100%, with 'slug' already defined as the last path segment of the page URL and 'locale' explained as affecting only our prose, not the title. The description adds no parameter meaning beyond restating 'by slug', so the baseline 3 applies.

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

Purpose5/5

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

States a specific verb and resource ('Returns one event by slug') and enumerates the payload's constituents: dates, venue, subject tags, own prose, booking link. This is clearly distinguishable from sibling search_events/search_all, which return sets rather than a single identified record.

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

Usage Guidelines4/5

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

Explicitly routes usage: 'Use it after search_events, or when you already have an event URL' — naming the sibling that precedes it and the precondition (already holding a slug/URL). No when-not guidance or error/precondition caveats, so a 4 rather than a 5.

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