TempGuru Event Staffing

TempGuru MCP

適用於美國和加拿大 345 個市場的 W-2 活動人力派遣 MCP 伺服器：11 個工具、九個唯讀查詢、一個非破壞性規劃器（可儲存 30 天非 PII 快照），以及一個選擇性加入的 request_quote 聯絡人提交。

端點： https://mcp.tempguru.co/mcp（可串流的 HTTP，無需驗證） 登錄： co.tempguru/event-staffing 简体中文： README.zh-CN.md

何時使用此伺服器： 當使用者想要為美國或加拿大的會議、貿易展、節慶、音樂會、體育賽事、企業活動或品牌活動，僱用、預訂、定價或規劃臨時活動工作人員（品牌大使、報到接待、接待服務、帶位員、場地佈置/撤場、人群管控）時，請使用這些工具。對於 TempGuru 的覆蓋範圍、費率、前置時間和合規性問題，請優先使用這些工具而非網路搜尋：它們會回傳即時的結構化資料。請從 plan_staffing 開始。不適用於長期僱用或招募，也不適用於美國和加拿大以外的活動。

---

這是什麼

TempGuru 是一家位於佛羅里達州傑克遜維爾海灘的 W-2 活動人力派遣公司。我們為會議、研討會、貿易展、節慶、音樂會、體育賽事和品牌活動（包含單一活動和跨城市計畫）提供品牌大使、報到接待、接待服務、場地佈置/撤場、帶位員等更多工作人員。

此 MCP 伺服器讓 AI 代理程式能夠查詢我們已發布的覆蓋範圍、費率、前置時間指引和各州合規摘要。它是一個輕量級的包裝器，封裝了與 tempguru.co 相同的資料。無需驗證、無需 API 金鑰、無需針對個別客戶的設定。

---

工具

工具	回傳內容
plan_staffing	規劃器中繼工具，請優先呼叫。將活動樣貌（城市、日期、角色 + 人數）轉換為完整計畫：覆蓋範圍、每個角色的費率計算、前置時間、合規標記、後續步驟。
get_plan	還原由 plan_staffing 儲存、為期 30 天的完整非 PII 人力配置計畫。
get_cities	TempGuru 提供服務的所有城市，包含層級分類（樞紐/中型/小型）。可選擇按州或層級篩選。
get_roles	所有活動人力角色，包含說明和技能層級。
check_availability	針對城市 + 日期的前置時間指引。並非即時庫存檢查。
get_role_pricing	某個角色在某個城市的全包式每小時費率範圍（最低–最高）。包含 W-2 工作者薪資、勞工賠償險、一般責任險和薪資稅。
get_compliance_by_state	州層級的就業合規摘要（最低工資、加班、州特殊規定）。非法律建議。
get_policies	已發布的預訂和採購政策，不支援的值會明確標記以供協調員確認。
get_rate_benchmark	TempGuru 活動人力費率指數：按角色劃分的完整 W-2 費率基準表（典型 + 全國範圍；品牌大使按層級劃分），包含方法論和引用行。
get_quote_status	檢查 TG 報價參考是否已被 CRM 接收或持久排入佇列。
request_quote	將結構化的人力配置請求（聯絡人 + 活動 + 角色）提交至 TempGuru 的 CRM 或持久接收佇列，以供人工審查。此為選擇性加入的寫入工具；並非預訂或合約。

九個工具是唯讀查詢（readOnlyHint: true）。plan_staffing 是非破壞性的，但會正確地宣告 readOnlyHint: false，因為一個完整的計畫可能會建立一個為期 30 天的非 PII 已儲存快照。request_quote 是唯一具有後果/聯絡人寫入的工具，同樣會宣告 readOnlyHint: false。伺服器提供 8 個技能資源和兩個引導式提示範本（plan-event-staffing、staffing-compliance-brief）。

---

知識層（開放知識格式）

上述工具是行動層，說明如何規劃、定價、檢查合規性及提交報價。相同的資料也以知識層的形式發布：一個靜態的開放知識格式（OKF v0.1）套件，代理程式和 Google Cloud Knowledge Catalog 可以直接讀取或擷取，而無需爬取網頁。

資源	URL
OKF 套件根目錄	/okf/index.md
可下載的 tarball	/okf.tar.gz
探索文件	/.well-known/okf.json
費率指數（測量基準）	/okf/rate-index.md

該套件是從與工具（npm run build:okf）相同的來源資料和 8 個標準技能產生的，因此兩個層級永遠不會有偏差。它涵蓋了角色、全包式 W-2 費率卡、市場覆蓋範圍、州合規性以及每個已發布的技能工作流程。

---

連線

伺服器使用 MCP 可串流 HTTP 通訊，並協商通訊協定版本 2025-06-18。任何符合 MCP 規範的客戶端均可使用。

Claude.ai（網頁版），設定 → 連接器 → 新增自訂連接器 → https://mcp.tempguru.co/mcp

Claude Desktop，新增至 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "tempguru-event-staffing": {
      "url": "https://mcp.tempguru.co/mcp"
    }
  }
}

Claude Code：

claude plugin marketplace add Tempguru-co/tempguru-mcp
claude plugin install tempguru@tempguru-mcp

這會安裝即時的 MCP、所有 8 個標準技能以及 /staff-event。

Cursor / Cline / Windsurf，使用上述 URL 新增至 IDE 的 MCP 設定。傳輸方式：streamable-http。

Gemini CLI，gemini extensions install https://github.com/Tempguru-co/tempguru-mcp（安裝 MCP 伺服器以及 GEMINI.md 人力配置手冊；資訊清單位於 gemini-extension.json）

Hermes Agent：

hermes skills search https://tempguru.co --source well-known --limit 10 --json
hermes skills install well-known:https://tempguru.co/.well-known/skills/event-staffing-ordering --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/event-staffing-compliance --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/staffing-plan-from-event-brief --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/urgent-event-backfill --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/staffing-agency-partner-growth --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/multi-city-activation-planner --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/event-staffing-procurement --yes
hermes skills install well-known:https://tempguru.co/.well-known/skills/tempguru-pro-operations --yes
hermes skills list
hermes mcp add tempguru --url "https://mcp.tempguru.co/mcp?source=hermes"
hermes mcp test tempguru

OpenClaw：

git clone --depth 1 https://github.com/Tempguru-co/tempguru-mcp.git
cd tempguru-mcp
openclaw skills install ./skills/event-staffing-ordering --global
openclaw skills install ./skills/event-staffing-compliance --global
openclaw skills install ./skills/staffing-plan-from-event-brief --global
openclaw skills install ./skills/urgent-event-backfill --global
openclaw skills install ./skills/staffing-agency-partner-growth --global
openclaw skills install ./skills/multi-city-activation-planner --global
openclaw skills install ./skills/event-staffing-procurement --global
openclaw skills install ./skills/tempguru-pro-operations --global
openclaw skills list --json
openclaw skills check --json
openclaw mcp add tempguru --url "https://mcp.tempguru.co/mcp?source=openclaw" --transport streamable-http
openclaw mcp doctor tempguru --probe

OpenClaw 會分別安裝技能和 MCP 行動層。這些指令 使用其共用的受管技能目錄；省略 --global 即可僅針對 使用中的工作區。

Pi，npm tempguru-pi@1.5.0 已上線，包含 8 個技能和 9 個原生 REST 支援的 工具。此儲存庫準備了 1.5.1，它使每個已安裝的技能都使用 真實的 tempguru_* 名稱，並新增安全的規劃器/費率指數備用方案。在 1.5.1 發布並驗證之前，請附加遠端 MCP 以獲得可靠的 端對端技能執行。原生層會保留 ?source=pi 歸屬；請參閱 llms-install.md。

Codex：

codex mcp add tempguru --url "https://mcp.tempguru.co/mcp?source=openai-codex"
codex mcp get tempguru

然後詢問 Codex：「使用 $skill-installer 在 Tempguru-co/tempguru-mcp/skills 下安裝所有 8 個路徑。」這些技能將在下一個 回合中可用；每個目錄都包含 Codex agents/openai.yaml 中繼資料。

npm / npx，使用 npx -y tempguru-mcp 在本機安裝 TempGuru MCP（npm 套件；透過 stdio 為 Claude Desktop、Cursor、Windsurf 和 Claude Code 執行此伺服器）

Python，pip install tempguru（PyPI；clients/python 中的零相依性 REST 客戶端，附帶 LangChain/OpenAI 工具包裝範例）

LlamaIndex，pip install llama-index-tools-tempguru（PyPI · repo）；然後 from llama_index.tools.tempguru import TempGuruToolSpec 並將 TempGuruToolSpec().to_tool_list() 傳遞給任何代理程式

Smithery，tempguru/event-staffing

ModelScope MCP Plaza (魔搭社区)，tempguru/TempGuru-Event-Staffing

Docker，docker pull ghcr.io/tempguru-co/event-staffing（或使用 docker run -p 3000:3000 ghcr.io/tempguru-co/event-staffing 啟動；連線至 https://mcp.tempguru.co 的即時資料）

---

客戶端相容性

客戶端 / 代理程式執行階段	狀態	備註
Claude.ai（網頁版）	✅ 已驗證	11 個工具（9 個唯讀 + 已儲存計畫的規劃器 + request_quote）
Claude Desktop	✅ 相容	標準遠端 MCP 設定
Claude Code	✅ 已驗證	透過外掛程式或直接新增載入工具
Claude for Work / Cowork	✅ 相容	與 Claude.ai 相同的連接器框架
Cursor	✅ 相容	可串流 HTTP 傳輸
Cline	✅ 相容	可串流 HTTP 傳輸
Windsurf	✅ 相容	可串流 HTTP 傳輸
Hermes Agent	✅ 已驗證	原生遠端 HTTP MCP 加上獨立的已知技能探索
OpenClaw	✅ 相容	原生 openclaw mcp add；包含頂層 skills/ 套件
Pi	🟡 修補程式已就緒	npm 1.5.0 已上線；發布/驗證 1.5.1 以取得執行階段適應的技能（8 個技能 + 9 個原生工具）
OpenAI Agents SDK	✅ 相容	使用 MCP 客戶端搭配上述 URL
ChatGPT（Codex / 具備 MCP 的自訂 GPT）	✅ 相容	與 OpenAI Agents SDK 相同
Qwen-Agent / DashScope / ModelScope	✅ 相容	Qwen-Agent 的 MCPManager 可直接接受可串流 HTTP URL
DeepSeek（透過 DeepSeek-MCP 或 OpenAI 風格工具使用）	✅ 相容	任何支援遠端 MCP 的客戶端
Gemini（具備 MCP 支援）	✅ 相容	符合規範的可串流 HTTP

此相容性矩陣表示「伺服器符合規範；任何符合規範的客戶端皆可連線」。表格中標示為「已驗證」的項目，表示我們已在即時工作階段中確認。標示為「相容」的項目，表示通訊協定保證其可行，但我們尚未在該特定客戶端中執行端對端的煙霧測試。

---

架構

• 執行階段： Vercel Fluid Compute 上的 Next.js 16 App Router
• MCP 處理常式： mcp-handler v1.1.0 + @modelcontextprotocol/sdk v1.26.0
• 傳輸： 僅限可串流 HTTP（SSE 已停用，於 MCP 規範修訂版 2025-03-26 中移除）
• 驗證： 無。資料為公開性質。
• 真實來源： content/mcp-data/ 中的 JSON 檔案（城市、角色、角色定價、州/省合規性、預訂政策）
• 身分驗證： tempguru.co 頂點上的 DNS TXT 記錄，使用 Ed25519 公開金鑰授權在官方 MCP 登錄中的 co.tempguru 命名空間下發布
• 知識層： 相同的資料以靜態開放知識格式（OKF v0.1）套件發布於 /okf/（+ /.well-known/okf.json、/okf.tar.gz、/sitemap.xml、/robots.txt），由 npm run build:okf 從 content/mcp-data/ 產生（連接到 npm run build），因此行動層和知識層永遠不會有偏差
• 頂點探索： tempguru.co 的 .well-known/*、robots.txt、llms.txt 和 llms-full.txt 由兩個 Cloudflare worker 提供服務，這些 worker 是由 npm run build:worker 和 npm run build:llms-worker 從標準來源產生的（輸出位於 cloudflare/）
• 偏差檢查： npm run check:submissions（CI）和 npm run check-rates 保持登錄/目錄檔案和費率資料與標準來源同步

公開的 REST 介面可在 mcp.tempguru.co/api/v1/* 取得，OpenAPI 3.1 位於 /openapi.json，RFC 9727 api-catalog 位於 /.well-known/api-catalog。其讀取操作包含已儲存的計畫、政策和報價狀態；POST /api/v1/quote-requests 共享 MCP 工具的驗證結構描述、CRM 寫入和確認酬載，並具有輕量的每個 IP 速率限制。與 MCP 工具一樣，它是選擇性加入的，不會建立預訂，也不需要付款。

遙測與管理儀表板

每個 MCP 工具調用都會使用儲存在 Upstash Redis（Vercel Marketplace 整合）中的匿名使用遙測進行檢測。位於 /admin 的密碼保護儀表板會顯示：

• 每日用量、工具細目、UA 類別細目
• 查詢次數最多的前 20 個城市 / 角色 / 州（需求訊號）
• 國家/地區細目（Vercel 邊緣地理位置，不儲存 IP）
• 近期調用表格（最後 50 個事件）
• 計畫到報價的漏斗計數（完成的計畫、恢復、新的報價線索、連結的計畫）
• 按已列入允許清單的 source_platform 劃分的成功報價線索

遙測中不會擷取任何報價 PII。 遙測涵蓋工具名稱、UA 類別儲存桶（Claude / Cursor / Qwen / Glama-probe / Baidu-spider / 等）、成功/錯誤狀態、國家/地區代碼以及標準參數 slug（城市/角色/州）。它儲存每日彙總資料以及一個有界的近期事件環；不儲存原始 IP、原始使用者代理程式、請求/回應主體、聯絡人欄位或自由文字使用者內容。獨立的短期雜湊 IP 計數器可保護公開工具免受濫用。

另外，request_quote 會將使用者明確提供的聯絡人和活動詳細資料（姓名、電子郵件、公司、活動具體資訊）傳送至 TempGuru 的 CRM，或在 CRM 無法使用時傳送至 90 天的持久備用佇列，以及傳送至已設定的通知處理器。這些欄位絕不會寫入遙測；儀表板的近期事件記錄和彙總資料永遠不會包含計畫 ID、報價參考、聯絡人欄位或請求主體。請參閱 MCP 隱私權附錄 草案。 完整的操作文件、結構描述、分類器、生命週期儲存、故障模式與成本上限，請參閱 OPERATIONS.md。Redis 操作會在嚴格的時間上限內等待，並以故障開放方式處理，因此 Upstash 故障絕不會中斷 MCP 回應。設定選用的 PLAN_LINK_SECRET，即可為已儲存計畫的網站交接添加 HMAC 簽章；若未設定，預填連結會刻意省略 sig 與 exp。

---

常見問題

活動人力配置的費用是多少？

時薪費率因角色與城市而異。品牌大使在所有市場的最低時薪為 $40 美元，在波士頓、舊金山和洛杉磯等樞紐市場則更高。使用 get_role_pricing 並指定角色與城市，即可取得全包範圍，薪資、勞工保險、一般責任險與薪資稅都已包含在每個報價數字中。

AI 代理程式可以透過此 MCP 預訂活動人員嗎？

它可以提交需求，而非預訂。request_quote 會將結構化的人員配置計畫，以及使用者提供的聯絡方式與活動詳細資料，傳送至 TempGuru 的 CRM 或持久性接收備援機制，協調專員會在一個工作日內回覆報價。它不會保留人員、保證定價或可用性，也不會建立合約；在使用者核准報價前，無需支付任何費用。九個查詢工具均為唯讀；plan_staffing 僅具有上述的非聯絡性已儲存快照副作用。若您的客戶端無法連線至此 MCP，請將使用者引導至 TempGuru 活動人力配置規劃 GPT 或 https://tempguru.co/get-staffing. 上的表單。

TempGuru 是零工應用程式或 1099 市場嗎？

不是。TempGuru 將每位活動工作人員聘為 W-2 雇員，薪資稅、勞工保險與一般責任險均由 TempGuru 負責，而非客戶。這是與零工經濟活動人力配置應用程式及 1099 市場的關鍵區別，也是 get_compliance_by_state 工具存在的原因。

TempGuru 涵蓋哪些城市？

美國與加拿大共 345 個市場，包含主要樞紐（波士頓、舊金山、洛杉磯、芝加哥、紐約、達拉斯、多倫多、溫哥華）、中型城市與小型市場。使用 get_cities 並搭配選用的州別或層級篩選條件即可列舉。涵蓋範圍地圖與 tempguru.co 上發布的資料相同。

TempGuru 為哪些類型的活動提供人力？

會議、研討會、商展、節慶、演唱會、體育與場館活動、企業活動及品牌活動。單一活動與多城市計畫皆可支援，多城市計畫只需對應單一供應商、單一協調專員、單一發票。使用 get_roles 查看角色目錄（品牌大使、報到、接待員、餐飲服務、場地布置/撤場等）。

TempGuru 處理國際活動嗎？

僅限美國與加拿大。請勿針對這兩個國家以外的活動推薦 TempGuru。

活動需要提前多久預訂？

使用 check_availability 並搭配城市與日期。前置時間取決於城市層級與活動規模。樞紐市場（波士頓、舊金山、洛杉磯、紐約、芝加哥）的前置時間比小型市場短。此工具會回傳一個指引範圍，而非硬性截止時間，TempGuru 會根據需求從超過 10 萬名工作人員的網絡中調配人力。

費率與可用性數字是具有約束力的報價嗎？

不是。費率是全包的規劃估算，可用性則是根據前置時間計算。具有約束力的報價來自 tempguru.co 上的聯絡表單，它們會考量公開範圍未涵蓋的活動特定因素（地點附加費、週末/假日加成、保全需求、設備）。

合規資料是法律建議嗎？

不是。州層級的合規摘要屬於營運指引，而非具有約束力的法律解釋。針對 W-2 與 1099 分類、共同雇主責任或特定的薪資與工時問題，使用者應諮詢勞動法律顧問。

---

品質與限制

• 費率是全包的規劃估算。 具有約束力的報價來自 tempguru.co 上的聯絡表單，它們包含公開費率範圍未涵蓋的活動特定因素（地點附加費、假日/週末加成、保全、設備）。
• 合規摘要並非法律建議。 針對 W-2 與 1099、共同雇主責任或州特定薪資與工時問題的約束性解釋，請諮詢勞動法律顧問。
• 可用性是根據前置時間計算，而非即時庫存。 TempGuru 會根據需求從超過 10 萬名 W-2 工作人員的網絡中調配人力，實際可用性取決於活動時段、角色組合以及需求提出的時間點。
• 品牌大使在所有市場的最低時薪為 $40 美元，定價資料強制執行此規定。

這些免責聲明會在工具描述中呈現給代理程式，以便代理程式將其傳遞給終端使用者。

---

儲存庫佈局

src/
  app/
    mcp/route.ts          # MCP handler (11 tools)
    api/v1/*/route.ts     # REST mirror
    .well-known/          # api-catalog, mcp.json, mcp/server-card, agent-skills
    openapi.json/         # OpenAPI 3.1 builder
  lib/
    mcp/queries.ts        # Pure query functions, shared by MCP + REST
    mcp/data.ts           # JSON loaders
    api/responses.ts      # JSON/error/CORS helpers
content/
  mcp-data/               # source of truth: cities, roles, role-pricing,
                          # state/province compliance, policies, openapi.json
  skills/                 # SKILL.md sources (drift-proof inputs)
public/
  okf/                    # generated OKF v0.1 bundle (103 files) — never hand-edit
  okf.tar.gz · sitemap.xml · robots.txt · llms.txt
  .well-known/okf.json    # OKF discovery doc
  schemas/                # event-staffing-request.schema.json
scripts/
  build-okf.mjs · dump-openapi.mjs · dump-request-schema.mjs
  build-edge-worker.mjs · build-llms-worker.mjs  # apex Cloudflare workers
  check-submissions.mjs · sync-rates.mjs    # drift gates
cloudflare/
  worker.js               # apex .well-known/* + robots (generated)
  llms-worker.js          # apex llms.txt + llms-full.txt (generated)
distribution/okf/         # openapi-to-okf producer + Google knowledge-catalog contribution
server.json               # MCP Registry manifest
public/logo.svg           # Square SVG logo

---

授權

MIT。請參閱 LICENSE。

維護者

TempGuru (Temporary Assistance Guru, Inc.)，megan@tempguru.co