TempGuru Event Staffing

CALL THIS FIRST for event staffing requests. Returns a configured-market catalog match, role-level W-2 rate math, estimated totals, tier-based lead-time guidance, and state compliance flags from the event's city, date, roles, and headcount. It does not confirm order coverage or live inventory; a coordinator does that after buyer submission. Use granular tools only for a single rate, date, or state fact. A complete plan may save a non-contact snapshot for 30 days and return plan_id plus continuation. If it returns no plan_id and the buyer needs persistence, call save_staffing_plan once; never save a plan that already has an ID. This tool never accepts or submits contact details, reserves staff, or creates a quote request. Omit roles for the catalog and a suggested mix. Treat totals as planning estimates, not quotes. Branch on status: plan, needs_roles, roles_not_found, or city_not_found; confirm suggestions rather than auto-applying them.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 120,
      "description": "Event city, name or slug (e.g., 'Chicago')."
    },
    "event_date": {
      "description": "Event date as YYYY-MM-DD; legacy recognizable dates are still accepted.",
      "type": "string",
      "maxLength": 40,
      "format": "date"
    },
    "event_type": {
      "description": "trade-show, conference, festival, concert, sporting-event, corporate, brand-activation, or other.",
      "type": "string",
      "maxLength": 80,
      "enum": [
        "trade-show",
        "conference",
        "festival",
        "concert",
        "sporting-event",
        "corporate",
        "brand-activation",
        "other"
      ]
    },
    "attendees": {
      "description": "Expected attendee count.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 5000000
    },
    "roles": {
      "description": "Roles and headcount. Omit to receive the role catalog and a suggested mix.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "maxLength": 80,
            "description": "Role name or slug."
          },
          "headcount": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 10000,
            "description": "Staff needed for this role."
          },
          "hours_per_shift": {
            "description": "Hours per shift (default 8, max 24).",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 24
          },
          "days": {
            "description": "Number of event days (default 1).",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 365
          }
        },
        "required": [
          "role",
          "headcount"
        ]
      }
    },
    "description": {
      "description": "Optional free-text event description, echoed into the plan.",
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "plan",
        "needs_roles",
        "roles_not_found",
        "city_not_found"
      ],
      "description": "Discriminator. Branch on this before reading the rest."
    },
    "plan_complete": {
      "description": "status:plan only. false = one or more requested roles could not be priced and are EXCLUDED from all totals (see unpriced_roles) — resolve them and re-plan before presenting a budget or quoting.",
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "tip": {
      "type": "string"
    },
    "available_roles": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "roles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "skill_tier": {
                    "type": "number"
                  },
                  "typical_shift_length_hours": {
                    "type": "number"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "slug",
                  "name"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "total",
            "roles"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "requested_city": {
      "type": "string"
    },
    "suggestion": {
      "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city",
            "role"
          ]
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "kind",
        "slug",
        "name"
      ],
      "additionalProperties": false
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "requested_roles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "unresolved_roles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string"
          },
          "headcount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hours_per_shift": {
            "type": "number"
          },
          "days": {
            "type": "number"
          },
          "suggestion": {
            "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "city",
                  "role"
                ]
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "slug",
              "name"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "role"
        ],
        "additionalProperties": false
      }
    },
    "unpriced_roles": {
      "description": "status:plan with plan_complete:false — the requested lines missing from every total.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string"
          },
          "headcount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hours_per_shift": {
            "type": "number"
          },
          "days": {
            "type": "number"
          },
          "suggestion": {
            "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "city",
                  "role"
                ]
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "kind",
              "slug",
              "name"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "role"
        ],
        "additionalProperties": false
      }
    },
    "event": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "market_tier": {
          "type": "string"
        },
        "catalog_match": {
          "type": "boolean",
          "const": true
        },
        "coverage_confirmation_required": {
          "type": "boolean",
          "const": true
        },
        "event_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "event_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "attendees": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "city",
        "state",
        "market_tier",
        "catalog_match",
        "coverage_confirmation_required"
      ],
      "additionalProperties": false
    },
    "plan_lines": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string"
          },
          "role_slug": {
            "type": "string"
          },
          "headcount": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hours_per_shift": {
            "type": "number"
          },
          "days": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hourly_range": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number",
                "description": "Lower end of the hourly rate range."
              },
              "high": {
                "type": "number",
                "description": "Upper end of the hourly rate range."
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": false,
            "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
          },
          "estimated_total_range": {
            "type": "object",
            "properties": {
              "low": {
                "type": "number"
              },
              "high": {
                "type": "number"
              }
            },
            "required": [
              "low",
              "high"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "role",
          "role_slug",
          "headcount",
          "hours_per_shift",
          "days",
          "hourly_range",
          "estimated_total_range"
        ],
        "additionalProperties": false
      }
    },
    "estimated_total_range": {
      "type": "object",
      "properties": {
        "low": {
          "type": "number"
        },
        "high": {
          "type": "number"
        },
        "currency": {
          "type": "string",
          "enum": [
            "USD",
            "CAD"
          ]
        },
        "basis": {
          "type": "string"
        }
      },
      "required": [
        "low",
        "high",
        "currency",
        "basis"
      ],
      "additionalProperties": false
    },
    "overtime_adjusted_total_range": {
      "description": "Present (non-null) only when daily/weekly OT (or a double-time band) applies to the schedule.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "low": {
              "type": "number"
            },
            "high": {
              "type": "number"
            },
            "currency": {
              "type": "string",
              "enum": [
                "USD",
                "CAD"
              ]
            },
            "includes_double_time": {
              "description": "True when a 2x band (CA/BC >12h/day, CA 7th consecutive day) is included.",
              "type": "boolean"
            },
            "note": {
              "type": "string"
            }
          },
          "required": [
            "low",
            "high",
            "currency",
            "note"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "lead_time": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "event_date": {
              "type": "string"
            },
            "days_until_event": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "recommendation": {
              "type": "string",
              "enum": [
                "yes",
                "tight",
                "rush",
                "very-rush"
              ]
            },
            "note": {
              "type": "string"
            }
          },
          "required": [
            "event_date",
            "days_until_event",
            "recommendation",
            "note"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "compliance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "jurisdiction": {
              "type": "string",
              "description": "US state or Canadian province the rules below belong to."
            },
            "min_wage_usd": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "US states only; null for Canadian provinces (coordinator confirms provincial wage floors)."
            },
            "overtime_weekly_hours": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "overtime_daily_hours": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "unique_rules": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "data_version": {
              "type": "string",
              "description": "Version identifier for the jurisdiction dataset used by the plan."
            },
            "data_current_as_of": {
              "type": "string",
              "description": "Date the jurisdiction dataset was last verified (YYYY-MM-DD)."
            },
            "min_wage_as_of": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Effective date of the stored wage floor; null when no wage is stored."
            },
            "min_wage_source": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uri"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Authoritative wage source; null for Canadian plans where the coordinator confirms the floor."
            },
            "currency_note": {
              "type": "string"
            },
            "citation_note": {
              "type": "string"
            },
            "note": {
              "type": "string"
            }
          },
          "required": [
            "jurisdiction",
            "min_wage_usd",
            "overtime_weekly_hours",
            "overtime_daily_hours",
            "unique_rules",
            "data_version",
            "data_current_as_of",
            "min_wage_as_of",
            "min_wage_source",
            "currency_note",
            "citation_note",
            "note"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "staffing_notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "offer_note": {
      "description": "Published first-order offer note. Totals remain undiscounted planning estimates.",
      "type": "string"
    },
    "plan_id": {
      "description": "Complete plans only. Non-PII plan reference retained for 30 days when Redis persistence succeeds.",
      "type": "string",
      "pattern": "^[A-HJ-NP-Z2-9]{12}$"
    },
    "continuation": {
      "description": "Complete plans only. Prefilled website handoff; may be present without plan_id when storage fails open.",
      "type": "object",
      "properties": {
        "form_url": {
          "type": "string",
          "format": "uri"
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "form_url",
        "note"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Explicitly save a complete non-contact staffing plan for 30 days so it can be shared, resumed, or linked to a later quote request. Use only when plan_staffing returned plan_complete:true without a plan_id and the user needs persistence. Never call this tool when plan_staffing already returned a plan_id. Provide the same confirmed city, date, event type, attendees, roles, headcount, hours, and days; the server recomputes rates, totals, lead time, and compliance before saving and does not accept caller-supplied pricing or totals. This does not reserve staff, submit contact details, or request a quote. <hints>Branch on status: saved is the only outcome with a durable plan_id; plan_incomplete requires revising the inputs; for rate_limited or storage_unavailable, give the buyer continuation.form_url directly because request_quote requires a saved plan_id.</hints>

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Event city, name or slug (e.g. Chicago)."
    },
    "event_date": {
      "description": "Event date as YYYY-MM-DD; legacy recognizable dates are still accepted.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "format": "date"
    },
    "event_type": {
      "description": "trade-show, conference, festival, concert, sporting-event, corporate, brand-activation, or other.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "enum": [
        "trade-show",
        "conference",
        "festival",
        "concert",
        "sporting-event",
        "corporate",
        "brand-activation",
        "other"
      ]
    },
    "attendees": {
      "description": "Expected attendee count.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 5000000
    },
    "roles": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "Role name or slug."
          },
          "headcount": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 10000,
            "description": "Staff needed for this role."
          },
          "hours_per_shift": {
            "description": "Hours per shift (default 8, max 24).",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 24
          },
          "days": {
            "description": "Number of event days (default 1).",
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 365
          }
        },
        "required": [
          "role",
          "headcount"
        ],
        "additionalProperties": false
      },
      "description": "Confirmed roles, headcount, hours, and days to recompute and save."
    }
  },
  "required": [
    "city",
    "roles"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "saved",
        "plan_incomplete",
        "rate_limited",
        "storage_unavailable"
      ],
      "description": "Discriminator. Only status:saved means a resumable plan_id exists."
    },
    "schema_version": {
      "type": "string",
      "const": "1.0"
    },
    "plan_id": {
      "description": "12-character reference for the saved non-PII snapshot.",
      "type": "string",
      "pattern": "^[A-HJ-NP-Z2-9]{12}$"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "expires_at": {
      "description": "Conservative 30-day expiry for the saved snapshot.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "resource_uri": {
      "description": "Public no-store REST URI that restores the saved artifact.",
      "type": "string",
      "format": "uri"
    },
    "continuation": {
      "type": "object",
      "properties": {
        "form_url": {
          "type": "string",
          "format": "uri"
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "form_url",
        "note"
      ],
      "additionalProperties": false
    },
    "quote_readiness": {
      "description": "The buyer must open the handoff form and personally submit their contact details.",
      "type": "string",
      "const": "buyer_submission_required"
    },
    "plan_status": {
      "description": "Planner branch that prevented persistence.",
      "type": "string",
      "enum": [
        "plan",
        "needs_roles",
        "roles_not_found",
        "city_not_found"
      ]
    },
    "retry_after_seconds": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "message": {
      "type": "string"
    },
    "next_actions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "share",
          "revise",
          "request_quote",
          "plan_again",
          "retry_save",
          "continue_on_website"
        ]
      }
    }
  },
  "required": [
    "status",
    "message",
    "next_actions"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Restore a complete non-PII staffing plan created by plan_staffing or save_staffing_plan within the last 30 days. Use when a buyer starts a new conversation, changes agent platforms, or wants to continue a saved plan before requesting a quote. DO NOT guess or enumerate plan IDs; use only the 12-character plan_id the user, plan_staffing, or save_staffing_plan supplied. <examples>get_plan(plan_id='ABCDEFGH2345')</examples> <hints>A not-found result means the plan expired, storage was unavailable, or the ID is wrong; re-run plan_staffing. Review the restored plan with the user before request_quote.</hints>

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "maxLength": 12,
      "pattern": "^[A-HJ-NP-Z2-9]{12}$",
      "description": "12-character lookalike-free plan reference returned by plan_staffing or save_staffing_plan."
    }
  },
  "required": [
    "plan_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "plan_found": {
      "type": "boolean",
      "description": "Discriminator. false means the reference was absent or expired."
    },
    "plan_id": {
      "type": "string"
    },
    "snapshot": {
      "type": "object",
      "properties": {
        "city": {
          "type": "object",
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "state": {
              "type": "string"
            }
          },
          "required": [
            "slug",
            "name",
            "state"
          ],
          "additionalProperties": false
        },
        "event": {
          "type": "object",
          "properties": {
            "event_date": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "event_type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "attendees": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "event_date",
            "event_type",
            "attendees"
          ],
          "additionalProperties": false
        },
        "plan_lines": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "role": {
                "type": "string"
              },
              "role_slug": {
                "type": "string"
              },
              "headcount": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "hours_per_shift": {
                "type": "number"
              },
              "days": {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              "hourly_range": {
                "type": "object",
                "properties": {
                  "low": {
                    "type": "number",
                    "description": "Lower end of the hourly rate range."
                  },
                  "high": {
                    "type": "number",
                    "description": "Upper end of the hourly rate range."
                  }
                },
                "required": [
                  "low",
                  "high"
                ],
                "additionalProperties": false,
                "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
              },
              "estimated_total_range": {
                "type": "object",
                "properties": {
                  "low": {
                    "type": "number"
                  },
                  "high": {
                    "type": "number"
                  }
                },
                "required": [
                  "low",
                  "high"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "role",
              "role_slug",
              "headcount",
              "hours_per_shift",
              "days",
              "hourly_range",
              "estimated_total_range"
            ],
            "additionalProperties": false
          }
        },
        "estimated_total_range": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number"
            },
            "high": {
              "type": "number"
            },
            "currency": {
              "type": "string",
              "enum": [
                "USD",
                "CAD"
              ]
            },
            "basis": {
              "type": "string"
            }
          },
          "required": [
            "low",
            "high",
            "currency",
            "basis"
          ],
          "additionalProperties": false
        },
        "overtime_adjusted_total_range": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "low": {
                  "type": "number"
                },
                "high": {
                  "type": "number"
                },
                "currency": {
                  "type": "string",
                  "enum": [
                    "USD",
                    "CAD"
                  ]
                },
                "includes_double_time": {
                  "type": "boolean"
                },
                "note": {
                  "type": "string"
                }
              },
              "required": [
                "low",
                "high",
                "currency",
                "note"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "compliance_jurisdiction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "channel": {
          "type": "string",
          "enum": [
            "mcp",
            "rest"
          ]
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "city",
        "event",
        "plan_lines",
        "estimated_total_range",
        "overtime_adjusted_total_range",
        "compliance_jurisdiction",
        "created_at",
        "channel",
        "source"
      ],
      "additionalProperties": false
    },
    "continuation": {
      "type": "object",
      "properties": {
        "form_url": {
          "type": "string",
          "format": "uri"
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "form_url",
        "note"
      ],
      "additionalProperties": false
    },
    "offer_note": {
      "description": "Published first-order offer note. Snapshot totals remain undiscounted.",
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "plan_found",
    "plan_id",
    "message",
    "next_steps"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

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. <examples>get_cities(city='Brooklyn') ; get_cities(state='TX') ; get_cities(tier='hub', country='CA') ; get_cities(limit=25)</examples> <hints>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.</hints>

{
  "type": "object",
  "properties": {
    "state": {
      "description": "Optional 2-letter state code (e.g., 'CA') or full state name.",
      "type": "string"
    },
    "tier": {
      "description": "Optional filter to one tier only.",
      "type": "string",
      "enum": [
        "hub",
        "mid",
        "small"
      ]
    },
    "country": {
      "description": "Optional country filter: 'US' or 'CA'.",
      "type": "string"
    },
    "city": {
      "description": "Optional single-city catalog match (nickname/borough aware). Returns catalog_match plus a suggestion; never a coverage promise.",
      "type": "string"
    },
    "limit": {
      "description": "Optional cap on the number of cities returned (full counts still in total/tier_breakdown).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "total": {
      "description": "Total cities matching the filter (before limit).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "returned": {
      "description": "Number of cities in the cities array (after limit).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "tier_breakdown": {
      "type": "object",
      "properties": {
        "hub": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "mid": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "small": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "hub",
        "mid",
        "small"
      ],
      "additionalProperties": false
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "state_abbr": {
            "type": "string"
          },
          "country": {
            "type": "string",
            "description": "US or CA."
          },
          "tier": {
            "type": "string",
            "enum": [
              "hub",
              "mid",
              "small"
            ],
            "description": "Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets."
          },
          "url": {
            "type": "string",
            "description": "City detail page on tempguru.co."
          }
        },
        "required": [
          "slug",
          "name",
          "state",
          "state_abbr",
          "country",
          "tier",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "coverage_confirmation_required": {
      "type": "boolean",
      "const": true
    },
    "catalog_qualification": {
      "type": "string"
    },
    "note": {
      "description": "Present when the list was truncated by limit.",
      "type": "string"
    },
    "catalog_check": {
      "description": "Present when a single-city catalog check was requested.",
      "type": "boolean",
      "const": true
    },
    "catalog_match": {
      "description": "Whether the city resolved to a configured catalog entry; not an availability or coverage promise.",
      "type": "boolean"
    },
    "requested": {
      "type": "string"
    },
    "suggestion": {
      "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city",
            "role"
          ]
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "kind",
        "slug",
        "name"
      ],
      "additionalProperties": false
    },
    "city": {
      "description": "The matched configured entry, or null when there was no catalog match.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "state": {
              "type": "string"
            },
            "state_abbr": {
              "type": "string"
            },
            "country": {
              "type": "string",
              "description": "US or CA."
            },
            "tier": {
              "type": "string",
              "enum": [
                "hub",
                "mid",
                "small"
              ],
              "description": "Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets."
            },
            "url": {
              "type": "string",
              "description": "City detail page on tempguru.co."
            }
          },
          "required": [
            "slug",
            "name",
            "state",
            "state_abbr",
            "country",
            "tier",
            "url"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "message": {
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

List event staffing roles TempGuru provides, with descriptions and skill tiers. Perfect for 'What kinds of event workers can I hire?', 'What roles do you staff for trade shows / festivals / corporate events?', or 'Do you have brand ambassadors?' questions. DO NOT use for what a role costs, use get_role_pricing with a city. <examples>get_roles()</examples> <hints>Returned slugs (brand-ambassadors, registration-staff, team-leads) are the exact values the other tools accept.</hints>

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "roles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Use this slug in pricing/availability lookups."
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "skill_tier": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "1 (entry) to 5 (lead)."
          },
          "typical_shift_length_hours": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "description",
          "skill_tier",
          "typical_shift_length_hours",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "total",
    "roles"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return tier-based lead-time guidance for an event date and configured market. Use for 'What's the typical lead time for brand ambassadors in [city]?' or 'Is this date inside the usual planning window?'. This is not a real-time inventory or order-coverage check: a TempGuru coordinator confirms coverage and final lead time for the specific order after buyer submission. DO NOT use for cost questions (use get_role_pricing) and never present the result as a reservation. <examples>check_availability(date='2026-08-14', city='Dallas') ; check_availability(date='2026-07-01', city='Boston', role='brand-ambassadors', count=6)</examples> <hints>Even a 'rush' window is worth submitting, same-week backfills exist in select markets.</hints>

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Event date as YYYY-MM-DD; legacy recognizable dates are still accepted."
    },
    "city": {
      "type": "string",
      "description": "City name (e.g., 'Boston') or slug (e.g., 'boston-event-staffing')."
    },
    "role": {
      "description": "Optional role name or slug to include rate context.",
      "type": "string"
    },
    "count": {
      "description": "Optional headcount for the event.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "date",
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "city_found": {
      "type": "boolean",
      "description": "false = city did not match the configured catalog (see message); true = planning guidance below, not confirmed coverage."
    },
    "requested": {
      "description": "Echo of the unmatched city input.",
      "type": "string"
    },
    "suggestion": {
      "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city",
            "role"
          ]
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "kind",
        "slug",
        "name"
      ],
      "additionalProperties": false
    },
    "message": {
      "description": "Present when city_found is false.",
      "type": "string"
    },
    "error": {
      "description": "Present when the date could not be parsed.",
      "type": "string"
    },
    "catalog_match": {
      "type": "boolean",
      "const": true
    },
    "coverage_confirmation_required": {
      "type": "boolean",
      "const": true
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "city_tier": {
      "type": "string",
      "enum": [
        "hub",
        "mid",
        "small"
      ],
      "description": "Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets."
    },
    "event_date": {
      "description": "Normalized ISO date (YYYY-MM-DD).",
      "type": "string"
    },
    "days_until_event": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "in_past": {
      "description": "True when the requested date is already in the past — confirm the date before planning.",
      "type": "boolean"
    },
    "typical_lead_time_hours": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "recommendation": {
      "description": "Lead-time guidance, NOT a reservation. Even rush is worth submitting.",
      "type": "string",
      "enum": [
        "yes",
        "tight",
        "rush",
        "very-rush"
      ]
    },
    "role_found": {
      "description": "null = no role requested; false = the requested role didn't match the catalog (see notes).",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    },
    "role_suggestion": {
      "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city",
            "role"
          ]
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "kind",
        "slug",
        "name"
      ],
      "additionalProperties": false
    },
    "role": {
      "description": "Rate context when a role was provided; null otherwise.",
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "rate_range_usd": {
              "type": "object",
              "properties": {
                "low": {
                  "type": "number",
                  "description": "Lower end of the hourly rate range."
                },
                "high": {
                  "type": "number",
                  "description": "Upper end of the hourly rate range."
                }
              },
              "required": [
                "low",
                "high"
              ],
              "additionalProperties": false,
              "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
            },
            "all_inclusive": {
              "type": "string"
            }
          },
          "required": [
            "name",
            "rate_range_usd",
            "all_inclusive"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "count": {
      "description": "Echo of the requested headcount.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "city_found"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Get the all-inclusive hourly rate range for a specific role in a specific city. Perfect for 'What does it cost to hire brand ambassadors in [city]?', 'How much are registration workers in [city]?', or 'What's the rate for ushers at a [city] stadium event?' questions. All rates include W-2 worker pay, workers comp, general liability, and payroll taxes. DO NOT use for availability or dates (use check_availability) and never present the range as a binding quote. For a multi-role budget, use plan_staffing. <examples>get_role_pricing(role='Brand Ambassadors', city='Boston') ; get_role_pricing(role='registration-staff', city='nashville-event-staffing')</examples> <hints>Role and city accept names or slugs. Brand Ambassadors floor at $40/hour in every market.</hints>

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "description": "Role name (e.g., 'Brand Ambassadors') or slug (e.g., 'brand-ambassadors')."
    },
    "city": {
      "type": "string",
      "description": "City name (e.g., 'Boston') or slug (e.g., 'boston-event-staffing')."
    }
  },
  "required": [
    "role",
    "city"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "role_found": {
      "description": "Present (false) only when the role didn't match.",
      "type": "boolean",
      "const": false
    },
    "available_roles": {
      "description": "The valid role catalog, returned when the role didn't match.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name"
        ],
        "additionalProperties": false
      }
    },
    "city_found": {
      "description": "Present (false) only when the city didn't match.",
      "type": "boolean",
      "const": false
    },
    "fallback_pricing": {
      "description": "All-tier pricing shown when the city didn't match.",
      "type": "object",
      "properties": {
        "small": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        },
        "mid": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        },
        "hub": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        }
      },
      "required": [
        "small",
        "mid",
        "hub"
      ],
      "additionalProperties": false
    },
    "note": {
      "type": "string"
    },
    "requested": {
      "description": "Echo of the unmatched input.",
      "type": "string"
    },
    "suggestion": {
      "description": "Closest known city/role for a miss. Confirm with the user before using it; do not auto-apply.",
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "city",
            "role"
          ]
        },
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "kind",
        "slug",
        "name"
      ],
      "additionalProperties": false
    },
    "error": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "role_slug": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "city_tier": {
      "type": "string",
      "enum": [
        "hub",
        "mid",
        "small"
      ],
      "description": "Market tier: hub = 25 major metros, mid = 128 secondary markets, small = 192 tertiary markets."
    },
    "hourly_range_low": {
      "type": "number"
    },
    "hourly_range_high": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "CAD"
      ]
    },
    "all_inclusive": {
      "type": "string"
    },
    "tier_definition": {
      "type": "string"
    },
    "all_tiers_for_context": {
      "type": "object",
      "properties": {
        "small": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        },
        "mid": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        },
        "hub": {
          "type": "object",
          "properties": {
            "low": {
              "type": "number",
              "description": "Lower end of the hourly rate range."
            },
            "high": {
              "type": "number",
              "description": "Upper end of the hourly rate range."
            }
          },
          "required": [
            "low",
            "high"
          ],
          "additionalProperties": false,
          "description": "All-inclusive hourly rate band (worker pay + payroll taxes + workers comp + liability)."
        }
      },
      "required": [
        "small",
        "mid",
        "hub"
      ],
      "additionalProperties": false,
      "description": "Rate bands across all three market tiers for context."
    },
    "pricing_notes": {
      "type": "string"
    },
    "role_note": {
      "description": "Caveat about the resolved role (e.g. 'security' maps to unarmed Crowd Control, not licensed security).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Get the event staffing compliance summary for a US state. Returns minimum wage, overtime rules, and state-specific quirks. Perfect for 'What are the W-2 vs 1099 rules for event workers in [state]?', 'What's the minimum wage for event staff in [state]?', or 'Are there compliance gotchas for hiring event workers in [state]?' questions. NOT legal advice, consult employment counsel for binding interpretation. DO NOT use for rates (use get_role_pricing). <examples>get_compliance_by_state(state='CA') ; get_compliance_by_state(state='Tennessee')</examples> <hints>Daily-overtime states (CA, AK, NV, CO) change shift budgeting, flag them in any plan.</hints>

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code (e.g., 'CA') or full state name (e.g., 'California')."
    }
  },
  "required": [
    "state"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "state_found": {
      "description": "Present (false) only when the state didn't match.",
      "type": "boolean",
      "const": false
    },
    "requested": {
      "type": "string"
    },
    "available_states": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "abbr": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "abbr",
          "name"
        ],
        "additionalProperties": false
      }
    },
    "state": {
      "type": "string"
    },
    "state_abbr": {
      "type": "string"
    },
    "min_wage_usd": {
      "description": "2026 state minimum wage.",
      "type": "number"
    },
    "w2_required": {
      "type": "boolean"
    },
    "w2_note": {
      "type": "string"
    },
    "overtime_threshold_weekly_hours": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "overtime_threshold_daily_hours": {
      "description": "Daily overtime threshold where the state has one (CA, AK, NV, CO); null otherwise.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "overtime_daily_double_hours": {
      "description": "Start of the double-time band (hours/day) where the state has one (CA: 12); null otherwise.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "seventh_day_overtime": {
      "description": "True where a seventh-consecutive-day premium applies (CA).",
      "type": "boolean"
    },
    "unique_rules": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "liability_coverage_included": {
      "type": "boolean"
    },
    "workers_comp_included": {
      "type": "boolean"
    },
    "min_wage_as_of": {
      "description": "Effective date of this state's stored minimum wage.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "min_wage_source": {
      "description": "Authoritative source URL for the minimum wage figure.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_version": {
      "description": "Version of the compliance dataset used for this result.",
      "type": "string"
    },
    "data_current_as_of": {
      "description": "Date the compliance dataset was last verified (YYYY-MM-DD).",
      "type": "string"
    },
    "currency_note": {
      "description": "Reminder that wages change annually; verify before relying.",
      "type": "string"
    },
    "citation_note": {
      "description": "Operational guidance, not legal advice.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Get TempGuru's published booking and procurement policies, plus any currently published public offer. Use for real booking questions that otherwise require an email. Values not supported by canonical copy are explicitly marked confirm_with_coordinator with TODO-for-Megan; never infer a missing number. <examples>get_policies() ; get_policies(topic='payment-terms') ; get_policies(topic='coi-additional-insured')</examples> <hints>Choose an advertised topic to return one policy. Narrow lexical aliases remain accepted, and unknown topics return the current available-topic list. This is an operational summary, not a contract.</hints>

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Optional canonical policy topic. Choose an advertised enum value; omit for all policies or a broader question.",
      "type": "string",
      "maxLength": 80,
      "enum": [
        "minimum-booking-hours",
        "cancellation-rescheduling",
        "no-show-backfill",
        "coi-additional-insured",
        "payment-terms",
        "background-checks",
        "order-confirmation",
        "quote-response",
        "offers"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "policies",
        "policy_not_found"
      ]
    },
    "policy_found": {
      "type": "boolean",
      "description": "Discriminator. false means the requested topic is not published."
    },
    "data_version": {
      "type": "string"
    },
    "updated": {
      "type": "string"
    },
    "scope": {
      "type": "string"
    },
    "policies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "confirmed_claims": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "confirm_with_coordinator": {
            "type": "boolean"
          },
          "todo_for_megan": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "code": {
            "type": "string"
          },
          "discount_percent": {
            "type": "number"
          },
          "cap_usd": {
            "type": "number"
          },
          "expires": {
            "description": "Offer expiry date in YYYY-MM-DD format.",
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
          },
          "scope": {
            "type": "string"
          }
        },
        "required": [
          "topic",
          "title",
          "confirmed_claims",
          "confirm_with_coordinator",
          "todo_for_megan",
          "sources"
        ],
        "additionalProperties": false
      }
    },
    "todo_for_megan": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disclaimer": {
      "type": "string"
    },
    "requested": {
      "type": "string"
    },
    "available_topics": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "message": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "policy_found"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

The TempGuru Event Staffing Rate Index: all-inclusive W-2 hourly bill rates by role from 407 measured US/Canada markets, as a typical rate plus the full national range (brand ambassadors shown by market tier), with methodology and a ready-to-use citation line. Perfect for 'What do event staff cost in 2026?', 'Industry benchmark for brand ambassador rates?', or any article, report, or comparison that needs citable staffing-rate data. DO NOT use for one city's price (use get_role_pricing) or to build an event budget (use plan_staffing). <examples>get_rate_benchmark() ; get_rate_benchmark(role='brand-ambassadors') ; get_rate_benchmark(tier='hub')</examples> <hints>Returns a national typical + range per role; brand ambassadors by tier. Pass tier to add each role's measured span within that tier (tier_usd). For one city's exact rate use get_role_pricing. Cite as: TempGuru Event Staffing Rate Index 2026, tempguru.co.</hints>

{
  "type": "object",
  "properties": {
    "role": {
      "description": "Optional non-empty role name or slug to filter to one role.",
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "tier": {
      "description": "Optional market tier; adds each role's measured span within that tier (tier_usd).",
      "type": "string",
      "enum": [
        "hub",
        "mid",
        "small"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "role_found": {
      "type": "boolean",
      "const": false
    },
    "requested": {
      "type": "string"
    },
    "available_roles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "index": {
      "type": "string"
    },
    "edition": {
      "type": "string"
    },
    "data_version": {
      "type": "string"
    },
    "updated": {
      "type": "string"
    },
    "methodology": {
      "type": "string"
    },
    "markets_measured": {
      "type": "object",
      "properties": {
        "small": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "mid": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "hub": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "small",
        "mid",
        "hub"
      ],
      "additionalProperties": false
    },
    "basis": {
      "type": "string"
    },
    "requested_tier": {
      "type": "string",
      "enum": [
        "hub",
        "mid",
        "small"
      ]
    },
    "reading_note": {
      "type": "string"
    },
    "rates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string"
          },
          "role_key": {
            "type": "string"
          },
          "typical_usd": {
            "type": "string"
          },
          "national_range_usd": {
            "type": "string"
          },
          "by_tier_usd": {
            "type": "object",
            "properties": {
              "small": {
                "type": "string"
              },
              "mid": {
                "type": "string"
              },
              "hub": {
                "type": "string"
              }
            },
            "required": [
              "small",
              "mid",
              "hub"
            ],
            "additionalProperties": false
          },
          "tier": {
            "type": "string",
            "enum": [
              "hub",
              "mid",
              "small"
            ]
          },
          "tier_usd": {
            "type": "string"
          }
        },
        "required": [
          "role",
          "role_key"
        ],
        "additionalProperties": false
      }
    },
    "floors": {
      "type": "string"
    },
    "citation": {
      "type": "string"
    },
    "methodology_url": {
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Use only after the buyer reviews a staffing plan and asks to proceed. Requires the saved non-PII plan_id from plan_staffing or save_staffing_plan and returns a prefilled TempGuru-owned review form. This tool never accepts or transmits names, email, phone, company, or other contact details and never creates a CRM lead or quote reference. The buyer must open form_url, review the plan, enter their own details, and submit it; only that submission creates a lead. This is not a reservation and does not guarantee pricing or availability. If a complete plan has continuation.form_url but no plan_id, give that URL directly instead. Never collect contact details for an MCP call; re-run an expired plan.

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "maxLength": 12,
      "pattern": "^[A-HJ-NP-Z2-9]{12}$",
      "description": "Saved non-PII plan reference returned by plan_staffing or save_staffing_plan."
    },
    "source_platform": {
      "description": "Optional agent/platform attribution, e.g. claude-ai, openclaw, or hermes.",
      "type": "string",
      "enum": [
        "ai-agent",
        "ai-page",
        "ai-page-zh",
        "baidu-agent",
        "chatgpt-app",
        "chatgpt-gpt",
        "claude-ai",
        "claude-code",
        "claude-desktop",
        "cn-agent",
        "copilot-agent",
        "coze",
        "coze-bot",
        "custom-gpt",
        "gemini",
        "gemini-cli",
        "gemini-gem",
        "hermes",
        "kimi",
        "langchain",
        "lechat-agent",
        "llamaindex",
        "manual-test",
        "meta-ai",
        "mcp-handoff",
        "open-webui",
        "openai-codex",
        "openclaw",
        "perplexity-space",
        "pi",
        "poe-bot",
        "postman",
        "prime-agent",
        "python-client",
        "skill",
        "team-demo",
        "website",
        "website-widget",
        "zhipu-agent",
        "openai-chatgpt",
        "openai-agents-sdk",
        "openai-mcp",
        "cursor",
        "cline",
        "windsurf",
        "perplexity",
        "qwen-ecosystem",
        "deepseek",
        "doubao",
        "mcp-client"
      ]
    },
    "skill_version": {
      "description": "Optional version of the TempGuru staffing skill used.",
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[0-9]{1,4}\\.[0-9]{1,4}\\.[0-9]{1,4}(?:-[0-9A-Za-z.-]{1,24})?(?:\\+[0-9A-Za-z.-]{1,24})?$"
    },
    "skill_id": {
      "description": "Optional canonical TempGuru skill that assembled the plan.",
      "type": "string",
      "enum": [
        "event-staffing-ordering",
        "event-staffing-compliance",
        "staffing-plan-from-event-brief",
        "urgent-event-backfill",
        "staffing-agency-partner-growth",
        "multi-city-activation-planner",
        "event-staffing-procurement",
        "tempguru-pro-operations"
      ]
    }
  },
  "required": [
    "plan_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "handoff_ready": {
      "type": "boolean",
      "description": "true when the saved plan resolved and a prefilled buyer form URL was created."
    },
    "buyer_submission_required": {
      "type": "boolean",
      "const": true,
      "description": "Always true. The buyer, not the agent, must enter contact details and submit the form."
    },
    "plan_found": {
      "type": "boolean",
      "description": "Whether the supplied non-PII plan_id resolved before expiry."
    },
    "plan_id": {
      "type": "string",
      "pattern": "^[A-HJ-NP-Z2-9]{12}$"
    },
    "form_url": {
      "description": "Prefilled TempGuru-owned review form. Present only when handoff_ready is true.",
      "type": "string",
      "format": "uri"
    },
    "message": {
      "type": "string",
      "description": "Human-readable outcome to relay to the buyer."
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Safe next actions; no agent-side contact collection."
    }
  },
  "required": [
    "handoff_ready",
    "buyer_submission_required",
    "plan_found",
    "plan_id",
    "message",
    "next_steps"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Check whether a TempGuru quote request reference was received by the CRM or durably queued. Use only after the buyer personally submitted a TempGuru website form and received a TG reference, or for a historical reference. The authless MCP request_quote handoff does not create a reference. This v1 status stub reports received/queued only; it does not yet expose quote_sent or won. <examples>get_quote_status(reference='TG-ABC234')</examples> <hints>Status records are retained for 90 days. A not-found result does not prove the CRM lead is absent; follow up with the reference at [email protected].</hints>

{
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "maxLength": 9,
      "pattern": "^TG-[A-HJ-NP-Z2-9]{6}$",
      "description": "TG reference returned after the buyer submits the TempGuru website form, e.g. TG-ABC234."
    }
  },
  "required": [
    "reference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "quote_found": {
      "type": "boolean",
      "description": "Discriminator. false means the status stub is absent or expired."
    },
    "reference": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "received",
        "queued"
      ]
    },
    "created_at": {
      "type": "string"
    },
    "deal_name": {
      "type": "string"
    },
    "channel": {
      "type": "string",
      "enum": [
        "mcp",
        "rest"
      ]
    },
    "message": {
      "type": "string"
    },
    "follow_up": {
      "type": "string"
    }
  },
  "required": [
    "quote_found",
    "reference",
    "message",
    "follow_up"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}