TempGuru MCP Server
Model Context Protocol server and public REST API for TempGuru event staffing data. Twelve tools: ten read-only tools, including a non-PII buyer handoff, plus a non-destructive planner that may save a 30-day non-PII snapshot, an explicit non-destructive save tool.
Evidence-verified public scale
- 300+ U.S. and Canadian marketsMarkets in the United States and Canada; availability is confirmed per order.
tg-claim-markets-300-plus-v1 - 5,000+ eventsDistinct non-canceled engagements after duplicate removal; a multi-day engagement counts once.
tg-claim-events-5000-plus-v1 - 100,000+ completed shiftsCompleted worker-shift assignments, not unique people, workers, placements, or network size.
tg-claim-completed-shifts-100000-plus-v1
The completed-shift figure counts worker-shift assignments, not unique people, workers, placements, or network size. Availability is confirmed per order.
MCP Endpoint
POST /mcpOfficial dual-era HTTP transport. Preferred MCP 2026-07-28 per-request envelopes, with stateless initialize/streamable-HTTP compatibility for supported 2025-era clients. Responses use JSON or SSE as required. No authentication.
Phase A workflow
- Call
plan_staffingfirst with the event city, date, roles, and headcount. - If the complete plan already includes a
plan_id, retain it and do not callsave_staffing_plan. The planner already saved the non-PII snapshot. - Call
save_staffing_planonly when a complete plan has noplan_idand needs a durable 30-day artifact. The server recomputes rates and totals before saving. - When the buyer asks to proceed, call
request_quotewith the savedplan_id, then give the buyer itsform_url. The buyer enters and submits their own contact details on that form.
MCP Tools
plan_staffingPlanner meta-tool, call first. Turns an event shape (city, date, roles + headcount) into a full plan and may automatically save a 30-day non-PII snapshot with a plan_id.save_staffing_planExplicitly save a complete plan after the server recomputes rates and totals from bounded event inputs. Use only when no plan_id already exists; never duplicate a plan_staffing autosave.get_planRestore a complete non-PII staffing plan saved for 30 days.get_citiesList configured market entries or match one city; catalog membership is not confirmed order coverage.get_rolesList all event staffing roles with descriptions and skill tiers.check_availabilityLead-time guidance for a city/date, optionally with role and headcount.get_role_pricingAll-inclusive hourly rate range for a specific role in a specific city.get_compliance_by_stateMinimum wage, overtime rules, and state-specific event-staffing compliance quirks.get_policiesPublished booking and procurement policies, with unsupported values explicitly deferred to a coordinator.get_rate_benchmarkThe Rate Index: a measured benchmark of all-inclusive W-2 hourly rates by role (typical + national range; Brand Ambassadors by tier), with methodology and citation line.get_quote_statusCheck a TG reference returned after the buyer submits the website form, including historical references.request_quoteRestore a saved non-PII plan and return a prefilled TempGuru form the buyer personally submits. Read-only; never accepts contact details or creates a lead.
Public REST API
Same data as the MCP tools, exposed as plain HTTP for clients that don't speak MCP. No authentication, JSON responses, CORS open. The read endpoints have a 1-hour public cache; the quote endpoint (POST /api/v1/quote-requests) is no-store and rate-limited.
GET /api/v1/citiesList cities (?state=&tier=)GET /api/v1/rolesList staffing rolesGET /api/v1/availabilityLead-time guidance (?city=&date=&role=&headcount=)GET /api/v1/pricingRate range per role per city (?role=&city=)GET /api/v1/complianceState compliance summary (?state=)GET /api/v1/policiesBooking and procurement policies (?topic=)GET /api/v1/plans/{id}Restore a saved non-PII staffing planPOST /api/v1/quote-requestsSubmit a staffing quote request (JSON body; the one write endpoint, opt-in, no reservation, no payment)GET /api/v1/quote-requests/{reference}Received/queued quote-request statusGET /api/v1/healthService health probe
Full machine-readable spec: /openapi.json · API catalog: /.well-known/api-catalog
Discovery & knowledge
Agent-readable surfaces for crawlers and clients that resolve a server without an install:
- /llms.txtLLM-oriented summary + links
- /okf/index.mdOpen Knowledge Format bundle (roles, rates, coverage, compliance, workflows)
- /.well-known/mcp.jsonDual-era MCP discovery document and Phase A workflow
- /.well-known/mcp/server-card.jsonSEP-1649 server card with the 12-tool inventory
- /.well-known/agent-skills/index.jsonAgent Skills index (SKILL.md digests)
- /.well-known/okf.jsonOKF bundle discovery
- /openapi.jsonOpenAPI 3.1 spec for the REST API
- /.well-known/security.txtSecurity contact (RFC 9116)
Operated by TempGuru. Docs: tempguru.co/ai-agents.