Skip to main content
Glama

events

by xyz.urbanplayground
OverviewDiscussionsAdmin

Get City Pulse

get_city_pulse
Read-onlyIdempotent

Use this when a user asks what's hot, how busy a city is this week, or about scene trends. Returns an aggregate read over the coming days: busiest nights (city-local dates), top venues (attendance-weighted), genre mix, headline events and free-event count, every stat with evidence counts. Public inventory only.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cityYesCity name or slug.
daysNoWindow length in days from date_from (1-14).
date_fromNoInclusive start date, YYYY-MM-DD. Defaults to today in the city.
event_typesNoOptional event-type filter, for example party.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • addedInput schema / properties / city / description
      Added value: +"City name or slug."
    • addedInput schema / properties / city / maxLength
      Added value: +200
    • addedInput schema / properties / date_from / description
      Added value: +"Inclusive start date, YYYY-MM-DD. Defaults to today in the city."
    • addedInput schema / properties / date_from / maxLength
      Added value: +200
    • addedInput schema / properties / days / default
      Added value: +7
    • addedInput schema / properties / days / description
      Added value: +"Window length in days from date_from (1-14)."
    • addedInput schema / properties / days / maximum
      Added value: +14
    • addedInput schema / properties / days / minimum
      Added value: +1
    • changedInput schema / properties / days / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / event_types / description
      Added value: +"Optional event-type filter, for example party."
    • addedInput schema / properties / event_types / items / maxLength
      Added value: +200
    • addedInput schema / properties / event_types / maxItems
      Added value: +50
  2. Changed6 schema fields changed
    • removedInput schema / properties / city / description
      Removed value: -"City name, for example berlin or new york."
    • removedInput schema / properties / date_from / description
      Removed value: -"Inclusive start date in YYYY-MM-DD format. Defaults to today."
    • removedInput schema / properties / days / default
      Removed value: -7
    • removedInput schema / properties / days / description
      Removed value: -"Window length in days starting from date_from (max 14)."
    • removedInput schema / properties / event_types / description
      Removed value: -"Optional event-type filter, for example party."
    • changedOutput schema / (root)
      Previous value: -{
-  "anyOf": [
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "busiest_nights": {
-          "items": {
-            "properties": {
-              "date": {
-                "type": "string"
-              },
-              "events": {
-                "type": "number"
-              },
-              "weekday": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "date",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "city": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "date_from": {
-          "type": "string"
-        },
-        "date_to": {
-          "type": "string"
-        },
-        "days": {
-          "type": "number"
-        },
-        "free_events_in_sample": {
-          "type": "number"
-        },
-        "headliners": {
-          "items": {
-            "properties": {
-              "attendance_count": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "calendar_url": {
-                "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "city": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "description": {
-                "description": "Short one-line event description for display.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "directions_url": {
-                "description": "Google Maps directions link. Offer as 'Get directions'.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ends_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "event_types": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "event_url": {
-                "type": "string"
-              },
-              "genres": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "id": {
-                "type": "string"
-              },
-              "lineup": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "price": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "starts_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ticket_url": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "title": {
-                "type": "string"
-              },
-              "venue": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "vibe": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "title",
-              "event_url"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "sample_note": {
-          "type": "string"
-        },
-        "sample_size": {
-          "type": "number"
-        },
-        "top_genres": {
-          "items": {
-            "properties": {
-              "events": {
-                "type": "number"
-              },
-              "genre": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "genre",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "top_venues": {
-          "items": {
-            "properties": {
-              "events": {
-                "type": "number"
-              },
-              "total_attendance": {
-                "type": "number"
-              },
-              "venue": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "venue",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "total_available": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "date_from",
-        "date_to",
-        "total_available",
-        "sample_size",
-        "busiest_nights",
-        "top_venues",
-        "top_genres",
-        "headliners"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "cause": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "classification": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "code": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "hostname": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "retryable": {
-          "type": "boolean"
-        },
-        "status": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "type": {
-          "type": "string"
-        },
-        "url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "error"
-      ],
-      "type": "object"
-    }
-  ],
-  "type": "object"
-}New value: +null
  3. Changed6 schema fields changed
    • addedInput schema / properties / city / description
      Added value: +"City name, for example berlin or new york."
    • addedInput schema / properties / date_from / description
      Added value: +"Inclusive start date in YYYY-MM-DD format. Defaults to today."
    • addedInput schema / properties / days / default
      Added value: +7
    • addedInput schema / properties / days / description
      Added value: +"Window length in days starting from date_from (max 14)."
    • addedInput schema / properties / event_types / description
      Added value: +"Optional event-type filter, for example party."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "assistant_instruction": {
+          "type": "string"
+        },
+        "busiest_nights": {
+          "items": {
+            "properties": {
+              "date": {
+                "type": "string"
+              },
+              "events": {
+                "type": "number"
+              },
+              "weekday": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "date",
+              "events"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "city": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date_from": {
+          "type": "string"
+        },
+        "date_to": {
+          "type": "string"
+        },
+        "days": {
+          "type": "number"
+        },
+        "free_events_in_sample": {
+          "type": "number"
+        },
+        "headliners": {
+          "items": {
+            "properties": {
+              "attendance_count": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "calendar_url": {
+                "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "city": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "description": {
+                "description": "Short one-line event description for display.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "directions_url": {
+                "description": "Google Maps directions link. Offer as 'Get directions'.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ends_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "event_types": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "event_url": {
+                "type": "string"
+              },
+              "genres": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "id": {
+                "type": "string"
+              },
+              "lineup": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "price": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "source": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "starts_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ticket_url": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "title": {
+                "type": "string"
+              },
+              "venue": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "vibe": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "event_url"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "sample_note": {
+          "type": "string"
+        },
+        "sample_size": {
+          "type": "number"
+        },
+        "top_genres": {
+          "items": {
+            "properties": {
+              "events": {
+                "type": "number"
+              },
+              "genre": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "genre",
+              "events"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "top_venues": {
+          "items": {
+            "properties": {
+              "events": {
+                "type": "number"
+              },
+              "total_attendance": {
+                "type": "number"
+              },
+              "venue": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "venue",
+              "events"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "total_available": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "date_from",
+        "date_to",
+        "total_available",
+        "sample_size",
+        "busiest_nights",
+        "top_venues",
+        "top_genres",
+        "headliners"
+      ],
+      "type": "object"
+    },
+    {
+      "properties": {
+        "assistant_instruction": {
+          "type": "string"
+        },
+        "cause": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "classification": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "code": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "error": {
+          "type": "string"
+        },
+        "hostname": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "retryable": {
+          "type": "boolean"
+        },
+        "status": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "type": {
+          "type": "string"
+        },
+        "url": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  4. Changed6 schema fields changed
    • removedInput schema / properties / city / description
      Removed value: -"City name, for example berlin or new york."
    • removedInput schema / properties / date_from / description
      Removed value: -"Inclusive start date in YYYY-MM-DD format. Defaults to today."
    • removedInput schema / properties / days / default
      Removed value: -7
    • removedInput schema / properties / days / description
      Removed value: -"Window length in days starting from date_from (max 14)."
    • removedInput schema / properties / event_types / description
      Removed value: -"Optional event-type filter, for example party."
    • changedOutput schema / (root)
      Previous value: -{
-  "anyOf": [
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "busiest_nights": {
-          "items": {
-            "properties": {
-              "date": {
-                "type": "string"
-              },
-              "events": {
-                "type": "number"
-              },
-              "weekday": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "required": [
-              "date",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "city": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "date_from": {
-          "type": "string"
-        },
-        "date_to": {
-          "type": "string"
-        },
-        "days": {
-          "type": "number"
-        },
-        "free_events_in_sample": {
-          "type": "number"
-        },
-        "headliners": {
-          "items": {
-            "properties": {
-              "attendance_count": {
-                "type": [
-                  "number",
-                  "null"
-                ]
-              },
-              "calendar_url": {
-                "description": "Prefilled Google Calendar link. Offer as 'Add to calendar'.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "city": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "description": {
-                "description": "Short one-line event description for display.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "directions_url": {
-                "description": "Google Maps directions link. Offer as 'Get directions'.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ends_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "event_types": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "event_url": {
-                "type": "string"
-              },
-              "genres": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "id": {
-                "type": "string"
-              },
-              "lineup": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "price": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "source": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "starts_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "ticket_url": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "title": {
-                "type": "string"
-              },
-              "venue": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "vibe": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "id",
-              "title",
-              "event_url"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "sample_note": {
-          "type": "string"
-        },
-        "sample_size": {
-          "type": "number"
-        },
-        "top_genres": {
-          "items": {
-            "properties": {
-              "events": {
-                "type": "number"
-              },
-              "genre": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "genre",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "top_venues": {
-          "items": {
-            "properties": {
-              "events": {
-                "type": "number"
-              },
-              "total_attendance": {
-                "type": "number"
-              },
-              "venue": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "venue",
-              "events"
-            ],
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "total_available": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "date_from",
-        "date_to",
-        "total_available",
-        "sample_size",
-        "busiest_nights",
-        "top_venues",
-        "top_genres",
-        "headliners"
-      ],
-      "type": "object"
-    },
-    {
-      "properties": {
-        "assistant_instruction": {
-          "type": "string"
-        },
-        "cause": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "classification": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "code": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "error": {
-          "type": "string"
-        },
-        "hostname": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "retryable": {
-          "type": "boolean"
-        },
-        "status": {
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "type": {
-          "type": "string"
-        },
-        "url": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "error"
-      ],
-      "type": "object"
-    }
-  ],
-  "type": "object"
-}New value: +null
  5. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent and non-destructive, so the safety profile is covered. The description adds real context beyond that: results are aggregate, stats carry evidence counts, city-local dates are used, and scope is public inventory only.

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?

Three sentences, front-loaded with the usage trigger before the return summary. The output enumeration is dense but each item is informative; nothing is redundant.

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

Completeness5/5

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

For a read-only aggregate tool with full schema coverage and no output schema, the description supplies the missing return-shape detail (the stats it returns and that they include evidence counts) plus scope and date semantics. An agent has everything needed to call it correctly.

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 the schema already documents city, days, date_from, and event_types with defaults and bounds. The description only loosely implies the days window ("coming days") without adding syntax or format detail beyond the schema, so 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+resource: an aggregate read over a city's coming days. It names concrete outputs (busiest nights, top venues, genre mix, headline events, free-event count) that clearly separate it from siblings like get_daily_roundup and search_events.

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?

Gives explicit trigger phrases ("what's hot," "how busy a city is this week," "scene trends") and a scope constraint ("Public inventory only"). It does not name an alternative or exclusion (e.g., when to prefer get_daily_roundup), so it stops short of full when/when-not guidance.

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

All events 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