Quote Submission

Submit a staffing quote request (the API's only write operation)

Use this when, and only when, the user has explicitly confirmed they want to submit a staffing request to TempGuru. This is the single write operation in this API; everything else is a read-only lookup. It creates a structured lead for human review, and a human coordinator replies with a quote within one business day (orders confirm within 48 hours of approval). Opt-in by design: collect the contact details and the event plan, show the user exactly what will be submitted, and call this once after explicit confirmation, never speculatively. Not a reservation: it does not hold staff, guarantee pricing or availability, or create a contract, and no payment is required until the user approves the quote. Contact and event details go to TempGuru's CRM or its durable fallback queue and configured notification processor so a coordinator can reply; they are never written to telemetry or analytics. Build the plan first with the read operations (cities, roles, pricing, availability, compliance). Lightly rate limited per source IP, on HTTP 429, respect Retry-After and fall back to the form at https://tempguru.co/get-staffing.

post/api/v1/quote-requests

Request

  • Base URL: https://mcp.tempguru.co
  • URL: https://mcp.tempguru.co/api/v1/quote-requests
  • Auth: none declared

Request body

contact_namestring required

Full name of the contact person

contact_emailstring email required

Contact email address for the quote response

contact_phonestring

Optional phone number for the coordinator to reach the buyer (event ops is phone-first; include when known)

companystring required

Company or organization name

event_namestring required

Name of the event (e.g. 'HIMSS 2026', 'Brand Fest Austin')

event_typestring required

Event type: trade-show, conference, festival, concert, sporting-event, corporate, brand-activation, or other

citystring required

City where the event is held

event_datesstring required

Event dates as a human-readable string, e.g. 'June 15–17, 2026'

venuestring

Primary venue name and/or address, when known

attendeesinteger

Expected event attendance, if known (informs coverage ratios)

budget_rangestring

Estimated total budget range if calculated, e.g. '$8,400–$12,600'

attirestring

Staff attire requirements

special_requirementsstring

Any special requirements: language skills, certifications, overnight shifts, etc.

compliance_notesstring

Any compliance flags surfaced by get_compliance_by_state

source_platform'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'

Optional agent/platform attribution, e.g. chatgpt-gpt, claude-desktop, coze

utm_source'ai-agent'

Canonical acquisition source carried by a TempGuru-generated buyer handoff URL

utm_medium'mcp' | 'rest' | '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'

Canonical agent runtime or MCP/REST medium carried by the buyer handoff URL

utm_campaign'quote-handoff'

Canonical TempGuru buyer-handoff campaign

utm_content'mcp' | 'rest'

Canonical originating MCP or REST channel for an attributed handoff

skill_versionstring

Optional version of the TempGuru staffing skill used to assemble this request

skill_id'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'

Optional canonical TempGuru skill slug that assembled this request

plan_idstring

Optional plan_id returned by plan_staffing or save_staffing_plan; links the submitted quote to its saved non-PII plan

Response

Request accepted into TempGuru's CRM or durable intake queue for human review. Relay message and next_steps to the user.

submittedtrue required
plan_linkedboolean required

True when the submitted plan_id resolved and its snapshot was attached.

deal_namestring required

Internal name assigned to the lead in TempGuru's CRM.

referencestring required

Quote reference to save and cite when following up.

messagestring required

Human-readable confirmation to relay to the user.

next_stepsstring[] required

What happens next, relay to the user.

Example response

{
  "deal_name": "Agent Quote, trade-show · Boston · June 15–17, 2026"
}

Changes

No recorded changes to this operation across all 1 revision of this API.