TempGuru Event Staffing

Get Cities

get_cities

Read-only

List configured market entries by tier, or match one city. Catalog presence is not availability or order coverage; check_availability gives tier-based lead-time guidance only, and a coordinator confirms each order after buyer submission. Use for 'What markets are configured in [state]?', 'Is [city] in the catalog?', or 'Which Canadian markets are listed?'. For 'Do you cover [city]?' pass city='[name]', report the catalog match or suggestion, and preserve the coordinator-confirmation caveat. Use get_role_pricing for rates, check_availability for dates, or plan_staffing for a full plan. get_cities(city='Brooklyn') ; get_cities(state='TX') ; get_cities(tier='hub', country='CA') ; get_cities(limit=25) State accepts 'CA' or 'California'; country accepts US or CA. City resolves nicknames and boroughs. Unfiltered results are capped; use filters or limit. Configured entries are planning data; the public coverage claim is 300+ U.S. and Canadian markets.

Input Schema

TableJSON Schema

Name	Required	Description
`city`	No	Optional single-city catalog match (nickname/borough aware). Returns catalog_match plus a suggestion; never a coverage promise.
`tier`	No	Optional filter to one tier only.
`limit`	No	Optional cap on the number of cities returned (full counts still in total/tier_breakdown).
`state`	No	Optional 2-letter state code (e.g., 'CA') or full state name.
`country`	No	Optional country filter: 'US' or 'CA'.

Output Schema

TableJSON Schema

Name	Required	Description
`city`	No	The matched configured entry, or null when there was no catalog match.
`note`	No	Present when the list was truncated by limit.
`total`	No	Total cities matching the filter (before limit).
`cities`	No
`message`	No
`returned`	No	Number of cities in the cities array (after limit).
`requested`	No
`suggestion`	No	Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.
`catalog_check`	No	Present when a single-city catalog check was requested.
`catalog_match`	No	Whether the city resolved to a configured catalog entry; not an availability or coverage promise.
`tier_breakdown`	No
`catalog_qualification`	No
`coverage_confirmation_required`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed8 schema fields changedAug 10, 2026

changedInput schema / properties / city / description

Previous value: -"Optional single-city coverage check (nickname/borough aware). Returns covered yes/no + suggestion."New value: +"Optional single-city catalog match (nickname/borough aware). Returns catalog_match plus a suggestion; never a coverage promise."

addedOutput schema / properties / catalog_check

Added value: +{
+  "const": true,
+  "description": "Present when a single-city catalog check was requested.",
+  "type": "boolean"
+}

addedOutput schema / properties / catalog_match

Added value: +{
+  "description": "Whether the city resolved to a configured catalog entry; not an availability or coverage promise.",
+  "type": "boolean"
+}

addedOutput schema / properties / catalog_qualification
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / properties / city / description

Previous value: -"The matched market (coverage check), or null if not covered."New value: +"The matched configured entry, or null when there was no catalog match."

removedOutput schema / properties / coverage_check

Removed value: -{
-  "const": true,
-  "description": "Present when a single-city coverage check was requested.",
-  "type": "boolean"
-}

addedOutput schema / properties / coverage_confirmation_required
```
Added value: +{
+  "const": true,
+  "type": "boolean"
+}
```

removedOutput schema / properties / covered

Removed value: -{
-  "type": "boolean"
-}

Changed2 schema fields changedJul 29, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed2 schema fields changedJul 15, 2026

changedOutput schema / properties / cities / items / properties / tier / description

Previous value: -"Market tier: hub = 25 major metros, mid = 129 secondary markets, small = 191 tertiary markets."New value: +"Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets."

changedOutput schema / properties / city / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "country": {
-        "description": "US or CA.",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "slug": {
-        "type": "string"
-      },
-      "state": {
-        "type": "string"
-      },
-      "state_abbr": {
-        "type": "string"
-      },
-      "tier": {
-        "description": "Market tier: hub = 25 major metros, mid = 129 secondary markets, small = 191 tertiary markets.",
-        "enum": [
-          "hub",
-          "mid",
-          "small"
-        ],
-        "type": "string"
-      },
-      "url": {
-        "description": "City detail page on tempguru.co.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "slug",
-      "name",
-      "state",
-      "state_abbr",
-      "country",
-      "tier",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "country": {
+        "description": "US or CA.",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "slug": {
+        "type": "string"
+      },
+      "state": {
+        "type": "string"
+      },
+      "state_abbr": {
+        "type": "string"
+      },
+      "tier": {
+        "description": "Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets.",
+        "enum": [
+          "hub",
+          "mid",
+          "small"
+        ],
+        "type": "string"
+      },
+      "url": {
+        "description": "City detail page on tempguru.co.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "slug",
+      "name",
+      "state",
+      "state_abbr",
+      "country",
+      "tier",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedJul 11, 2026

changedOutput schema / properties / suggestion / description

Previous value: -"Closest known city/role for a miss; retry with this slug."New value: +"Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply."

Changed13 schema fields changedJul 7, 2026

addedInput schema / properties / city

Added value: +{
+  "description": "Optional single-city coverage check (nickname/borough aware). Returns covered yes/no + suggestion.",
+  "type": "string"
+}

addedInput schema / properties / country

Added value: +{
+  "description": "Optional country filter: 'US' or 'CA'.",
+  "type": "string"
+}

addedInput schema / properties / limit

Added value: +{
+  "description": "Optional cap on the number of cities returned (full counts still in total/tier_breakdown).",
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

addedOutput schema / properties / city

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "country": {
+          "description": "US or CA.",
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string"
+        },
+        "state": {
+          "type": "string"
+        },
+        "state_abbr": {
+          "type": "string"
+        },
+        "tier": {
+          "description": "Market tier: hub = 25 major metros, mid = 129 secondary markets, small = 191 tertiary markets.",
+          "enum": [
+            "hub",
+            "mid",
+            "small"
+          ],
+          "type": "string"
+        },
+        "url": {
+          "description": "City detail page on tempguru.co.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "slug",
+        "name",
+        "state",
+        "state_abbr",
+        "country",
+        "tier",
+        "url"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The matched market (coverage check), or null if not covered."
+}

addedOutput schema / properties / coverage_check

Added value: +{
+  "const": true,
+  "description": "Present when a single-city coverage check was requested.",
+  "type": "boolean"
+}

addedOutput schema / properties / covered
```
Added value: +{
+  "type": "boolean"
+}
```
addedOutput schema / properties / message
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / note

Added value: +{
+  "description": "Present when the list was truncated by limit.",
+  "type": "string"
+}

addedOutput schema / properties / requested
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / returned

Added value: +{
+  "description": "Number of cities in the cities array (after limit).",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

addedOutput schema / properties / suggestion

Added value: +{
+  "additionalProperties": false,
+  "description": "Closest known city/role for a miss; retry with this slug.",
+  "properties": {
+    "kind": {
+      "enum": [
+        "city",
+        "role"
+      ],
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "slug": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind",
+    "slug",
+    "name"
+  ],
+  "type": "object"
+}

changedOutput schema / properties / total / description

Previous value: -"Number of cities matching the filter."New value: +"Total cities matching the filter (before limit)."

removedOutput schema / required

Removed value: -[
-  "total",
-  "tier_breakdown",
-  "cities"
-]

Changed1 schema field changedJun 10, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "cities": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "country": {
+            "description": "US or CA.",
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "state_abbr": {
+            "type": "string"
+          },
+          "tier": {
+            "description": "Market tier: hub = 25 major metros, mid = 129 secondary markets, small = 191 tertiary markets.",
+            "enum": [
+              "hub",
+              "mid",
+              "small"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "description": "City detail page on tempguru.co.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "slug",
+          "name",
+          "state",
+          "state_abbr",
+          "country",
+          "tier",
+          "url"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "tier_breakdown": {
+      "additionalProperties": false,
+      "properties": {
+        "hub": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "mid": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "small": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "hub",
+        "mid",
+        "small"
+      ],
+      "type": "object"
+    },
+    "total": {
+      "description": "Number of cities matching the filter.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "total",
+    "tier_breakdown",
+    "cities"
+  ],
+  "type": "object"
+}

First observedJun 4, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Annotations already declare readOnlyHint=true, openWorldHint=false, and destructiveHint=false. The description adds meaningful behavioral context: configured entries are planning data, catalog presence does not promise availability or coverage, a coordinator must confirm orders, unfiltered results are capped, and the public coverage claim is 300+ markets. This goes well beyond the structured annotations.

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 dense but front-loaded with the core purpose and caveat, followed by use cases, examples, and hints. It is longer than the minimum, but every section earns its place given the semantic pitfalls an agent must avoid. The structure is organized and scannable.

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 lookup tool with 100% parameter documentation and an output schema, the description supplies all needed context: when to use it, how to answer common user questions, what caveats to preserve, how filters behave, and what sibling tools cover adjacent needs. Nothing material is missing for correct invocation.

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

Parameters5/5

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

Schema coverage is 100%, but the description still adds value by clarifying accepted formats ('CA' or 'California' for state, 'US' or 'CA' for country), nickname/borough resolution, the meaning of limit caps with full counts retained, and the fact that city matching returns a suggestion rather than a coverage promise. These nuances are not fully captured in the schema.

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?

The description opens with a specific verb and resource: 'List configured market entries by tier, or match one city.' It clearly distinguishes this tool from siblings like check_availability and get_role_pricing, and explicitly names the non-goal: catalog presence is not availability or order coverage.

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

Usage Guidelines5/5

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

The description gives concrete query patterns ('What markets are configured in [state]?', 'Is [city] in the catalog?'), provides example calls for several filter combinations, and explicitly names sibling tools for related tasks (get_role_pricing, check_availability, plan_staffing). It even instructs how to handle 'Do you cover [city]?' with the proper caveat.

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

All TempGuru Event Staffing tools Inspect

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.