TempGuru Event Staffing
官方TempGuru(Temporary Assistance Guru, Inc.)是一家符合W-2规定的活动人员供应商,服务于会议、大会、贸易展览、节庆、音乐会、体育及场馆活动、企业活动以及品牌推广活动——无论是单场活动还是多城市项目——覆盖美国和加拿大300多个市场。
你可以用 TempGuru Event Staffing MCP 做什么?
- 规划活动人员配置 — 通过
plan_staffing请求按城市、日期、角色和人数编制的完整人员配置计划,该操作可能会自动保存一份包含plan_id的 30 天快照。 - 查看角色定价 — 使用
get_role_pricing获取特定城市中某个角色的全包小时费率范围(W-2 工资、工伤赔偿、责任险、工资税)。 - 核实可用性提前期 — 在规划前,使用
check_availability查看基于层级、针对特定城市和日期的提前期指导。 - 审查州合规要求 — 使用
get_compliance_by_state获取运营合规摘要(最低工资、加班、州特殊规定);此内容不构成法律建议。 - 生成报价交接 — 在保存计划后,调用
request_quote并传入plan_id,以获取预填好的、由买方操作的form_url,用于个人提交。 - 浏览市场目录 — 使用
get_cities和get_roles枚举支持的城市和角色,并可根据需要按州或层级进行筛选。
文档
TempGuru MCP
双时代 MCP 服务器,服务于美国和加拿大 300+ 市场的 W-2 临时活动人员配置,拥有 5,000+ 场活动和 100,000+ 个已完成班次的支持。可用性按订单确认。十二个工具包括十个只读工具(包括一个非 PII 的报价表单交接)和两个非破坏性、非联系人的计划持久化工具。
端点: https://mcp.tempguru.co/mcp(双时代 HTTP,首选 MCP 2026-07-28 及 2025 时代兼容性,无需认证)
注册表: co.tempguru/event-staffing
简体中文: README.zh-CN.md
何时使用此服务器: 当用户想要在美国或加拿大为会议、贸易展、节日、音乐会、体育赛事、企业活动或品牌推广活动雇佣、预订、定价或规划临时活动人员(品牌大使、注册、接待、引座员、搭建/拆除、人群控制)时,请使用这些工具。对于 TempGuru 的市场目录、费率、提前期和合规性问题,优先使用这些工具而非网络搜索:它们返回实时结构化规划数据。从 plan_staffing 开始;协调员确认订单覆盖范围。不适用于永久雇佣或招聘,也不适用于美国和加拿大以外的活动。
这是什么
TempGuru 是一家总部位于佛罗里达州杰克逊维尔海滩的托管活动人员配置公司。在美国订单中,工人由经过审查的当地合作机构作为 W-2 雇员雇佣和支付;加拿大订单则按照加拿大规则在当地雇佣。我们为会议、大会、贸易展、节日、音乐会、体育赛事和品牌推广活动提供品牌大使、注册、接待、搭建/拆除、引座员等人员配置,涵盖单场活动和多城市项目。
此 MCP 服务器允许 AI 代理查询我们配置的市场目录、费率、基于层级的提前期指导和州合规摘要。目录匹配并非已确认的订单覆盖范围或实时库存;协调员在买家提交后确认具体订单。它是为 tempguru.co 提供支持的同一数据的轻量封装。无需认证、无需 API 密钥、无需按客户设置。
已验证的公开规模:
- 300+ 美国和加拿大市场(
tg-claim-markets-300-plus-v1)。可用性按订单确认。 - 5,000+ 场活动(
tg-claim-events-5000-plus-v1)。去重后不同的未取消参与;多日活动计为一次。 - 100,000+ 个已完成班次(
tg-claim-completed-shifts-100000-plus-v1)。已完成的工人班次分配,而非独立人员、工人、岗位或网络规模。
工具
| 工具 | 返回内容 |
|---|---|
plan_staffing | 规划器元工具,请先调用。将活动形态(城市、日期、角色 + 人数)转化为完整计划,并可能自动保存带有 plan_id 的 30 天非 PII 快照。 |
save_staffing_plan | 在根据有界事件输入重新计算费率和总计后,显式保存完整计划。仅在不存在 plan_id 且持久化有用时使用。 |
get_plan | 恢复由 plan_staffing 或 save_staffing_plan 保存的完整非 PII 人员配置计划,保留 30 天。 |
get_cities | 配置的规划条目,带层级分类(中心/中型/小型)。可选按州或层级过滤;匹配不确认订单覆盖范围。 |
get_roles | 所有活动人员配置角色,带描述和技能层级。 |
check_availability | 城市 + 日期的提前期指导。非实时库存检查。 |
get_role_pricing | 城市中角色的全包小时费率范围(低–高)。包括 W-2 工人工资、工伤赔偿、一般责任险和工资税。 |
get_compliance_by_state | 州级就业合规摘要(最低工资、加班、州特殊规定)。非法律建议。 |
get_policies | 已发布的预订和采购政策,不支持的值明确标记为需协调员确认。 |
get_rate_benchmark | TempGuru 活动人员配置费率指数:按角色的完整 W-2 费率基准表(典型 + 全国范围;品牌大使按层级),附方法论和引用行。 |
get_quote_status | 检查买家提交 TempGuru 网站表单后创建的 TG 引用,或历史 REST 创建的引用。MCP 交接不会创建引用。 |
request_quote | 只读、非 PII 买家交接。解析已保存的 plan_id 并返回预填的 TempGuru 拥有的 form_url;不接受联系详情,不创建 CRM 线索或报价引用。 |
十个工具宣传 readOnlyHint: true,包括幂等的 request_quote 交接。plan_staffing 和 save_staffing_plan 是仅有的写入操作;两者都是非破坏性、非联系人的计划持久化操作,带 readOnlyHint: false。因此连接器被分类为读/写,尽管它从不写入联系数据。服务器还附带 8 个技能资源和两个引导提示模板(plan-event-staffing、staffing-compliance-brief)。
Phase A 规划和保存工作流
- 首先使用活动城市、日期、角色和人数调用
plan_staffing。 - 如果完整计划包含
plan_id,请保留它并不要调用save_staffing_plan;规划器已保存快照。 - 如果完整计划没有
plan_id且可恢复或可共享的工件有用,请使用相同的已确认事件输入调用一次save_staffing_plan。 - 当买家确认已保存的计划并要求继续时,使用其必需的
plan_id和可选的允许列表归属(source_platform、skill_id、skill_version)调用request_quote。 - 将返回的
form_url交给买家。买家必须打开它、查看计划、输入自己的联系详情并亲自提交。只有该网站/REST 提交才会创建线索和 TG 引用。 - 如果存储未返回
plan_id,请勿调用request_quote;直接将完整计划的continuation.form_url交给买家。
知识层(开放知识格式)
上述工具是行动层,用于规划、定价、检查合规性和准备买家操作的报价表单交接。相同的数据也作为知识层发布:一个静态的 开放知识格式(OKF v0.1)包,代理和 Google Cloud 知识目录可以直接读取或摄取,而无需抓取网页。
| 资源 | URL |
|---|---|
| OKF 包根目录 | /okf/index.md |
| 可下载的压缩包 | /okf.tar.gz |
| 发现文档 | /.well-known/okf.json |
| 费率指数(实测基准) | /okf/rate-index.md |
该包由与工具相同的源数据和 8 个规范技能生成(npm run build:okf),因此两层永远不会漂移。它涵盖角色、全包 W-2 费率卡、配置的市场条目、州合规性以及每个已发布的技能工作流。
连接
服务器使用官方的双时代 HTTP 入口:首选 MCP 2026-07-28 每请求信封,加上对受支持的 2025 时代客户端的无状态 initialize/Streamable HTTP 兼容性。响应根据要求使用 JSON 或 SSE。任何符合 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 和 Prime Agent 共享独立版本化的 tempguru-pi 包:8 个运行时适配技能加 9 个原生 REST 支持的 工具。tempguru-pi@1.7.2 是实时的、当前的且不可变的;下面的未固定安装命令解析为 1.7.2。任何未来的修复必须使用下一个未使用的补丁,而不是重新发布 1.7.2。原生 tempguru_request_quote 是一个只读的已保存计划交接,返回买家表单而非发送联系数据。扩展在 Pi 中自动使用 source=pi,在 Prime Agent 中使用 source=prime-agent。
pi install npm:tempguru-pi
prime-agent package install npm:tempguru-pi
prime-agent package list
Prime Agent v0.7.0 已使用全部 8 个技能和全部 9 个原生工具进行测试。其内置的 Python MCP 集成目前需要 OAuth 或 bearer 令牌,因此请勿将 TempGuru 的无认证远程 MCP 添加到 Prime 设置中。三个仅 MCP 的操作(plan_staffing、save_staffing_plan 和 get_rate_benchmark)在原生适配器获得同等功能之前,在 Prime 内仍不可用。请参阅 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 · 仓库);然后 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(网页版) | ✅ 已验证 | 12 个工具(10 个只读,包括 request_quote,加规划器和显式非联系人保存) |
| Claude Desktop | ✅ 兼容 | 标准远程 MCP 配置 |
| Claude Code | ✅ 已验证 | 工具通过插件或直接添加加载 |
| Claude for Work / Cowork | ✅ 兼容 | 与 Claude.ai 相同的连接器框架 |
| Cursor | ✅ 兼容 | Streamable HTTP 传输 |
| Cline | ✅ 兼容 | Streamable HTTP 传输 |
| Windsurf | ✅ 兼容 | Streamable HTTP 传输 |
| Hermes Agent | ✅ 已验证 | 原生远程 HTTP MCP 加独立的 well-known 技能发现 |
| OpenClaw | ✅ 兼容 | 原生 openclaw mcp add;包含顶级 skills/ 包 |
| Pi | ✅ 1.7.2 实时且已验证 | 发布的工件暴露 8 个运行时适配技能 + 9 个原生工具;tempguru_request_quote 返回买家操作的表单且不发送联系数据 |
| Prime Agent v0.7.0 | ✅ 发布的工件功能冒烟测试通过 | 使用相同的 tempguru-pi@1.7.2 包契约:8 个技能 + 9 个原生工具,自动 source=prime-agent 归属;其内置 MCP 集成尚无法附加此无认证服务器 |
| OpenAI Agents SDK | ✅ 兼容 | 使用上述 URL 的 MCP 客户端 |
| ChatGPT(Codex / 带 MCP 的自定义 GPT) | ✅ 兼容 | 与 OpenAI Agents SDK 相同 |
| Qwen-Agent / DashScope / ModelScope | ✅ 兼容 | Qwen-Agent 的 MCPManager 直接接受 streamable-HTTP URL |
| DeepSeek(通过 DeepSeek-MCP 或 OpenAI 风格工具使用) | ✅ 兼容 | 任何支持远程 MCP 的客户端 |
| Gemini(带 MCP 支持) | ✅ 兼容 | 符合规范的 streamable HTTP |
该矩阵表示“服务器符合规范;任何符合规范的客户端都能连接。”表中标注“已验证”的地方,我们已在实时会话中确认。标注“兼容”的地方,协议保证可以连接,但我们尚未在该特定客户端中运行端到端冒烟测试。
架构
- 运行时: 基于 Vercel Fluid Compute 的 Next.js 16 App Router
- MCP 处理器: 官方
@modelcontextprotocol/serverv2.0.0 双时代入口 - 传输: MCP 2026-07-28 每请求 HTTP 以及无状态 2025 时代 initialize/Streamable HTTP 兼容;按需返回 JSON 或 SSE 响应
- 认证: 无。数据是公开的。
- 数据源:
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),由content/mcp-data/通过npm run build:okf生成(接入npm run build),确保操作层和知识层永不漂移 - 顶点发现: 一个由
npm run build:worker生成的 Cloudflare Worker 提供tempguru.co的.well-known/*、robots.txt、auth.md和schemas/*。网站拥有并部署顶点llms.txt和llms-full.txt;此仓库仅生成public/中单独的 MCP 托管导出。 - 漂移门控:
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。其读取操作包括已保存的计划、政策和报价状态。面向用户的 TempGuru 表单仅在买家查看预填内容、输入自己的联系信息并点击提交后使用 POST /api/v1/quote-requests;该单独的浏览器/REST 操作会创建 CRM 线索和 TG 引用。MCP 的 request_quote 工具不共享该包含联系信息的输入契约,也从不执行 REST 提交。
遥测与管理仪表板
每次 MCP 工具调用都会记录匿名使用遥测,存储在 Upstash Redis(Vercel Marketplace 集成)中。位于 /admin 的密码保护仪表板展示:
- 每日量、工具细分、UA 类别细分
- 查询最多的前 20 个城市/角色/州(需求信号)
- 国家/地区细分(Vercel 边缘地理定位,不存储 IP)
- 最近调用表(最近 50 个事件)
- 计划到表单漏斗计数(完整计划、简历、报价交接和买家提交的报价线索)
- 按允许列表的
source_platform成功的网站/REST 报价线索
MCP 遥测中不捕获报价 PII。 遥测涵盖工具名称、UA 类别桶(Claude / Cursor / Qwen / Glama-probe / Baidu-spider 等)、成功/错误状态、国家代码和规范参数 slug(城市/角色/州)。它存储每日聚合数据以及有界的近期事件环;不存储原始 IP、原始用户代理、请求/响应体、联系字段或自由文本用户内容。单独的短期哈希 IP 计数器保护公共工具免受滥用。
request_quote 仅接受已保存的非 PII plan_id 以及可选的允许列表归因,恢复该计划,并返回 https://mcp.tempguru.co 上的链接。它从不询问、接收或传输联系信息,也不创建 CRM 线索或 TG 引用。联系处理仅在买家打开表单、输入自己的信息并提交时开始;网站随后调用单独的 REST 接收。这些联系字段从不写入 MCP 产品遥测。请参阅草案 MCP 隐私附录。
完整的操作文档、模式、分类器、生命周期存储、故障模式和成本上限位于 OPERATIONS.md。Redis 操作在严格的时间上限后等待并失败开放,因此 Upstash 故障永远不会破坏 MCP 响应。设置可选的 PLAN_LINK_SECRET 以向已保存计划的网站交接添加 HMAC 签名;没有它,预填链接有意省略 sig 和 exp。
常见问题解答
活动人员配备费用是多少?
小时费率因角色和城市而异。品牌大使在所有市场的最低费率为每小时 40 美元,在波士顿、旧金山和洛杉矶等枢纽市场更高。使用 get_role_pricing 并指定角色 + 城市,获取全包范围;工资、工人赔偿、一般责任险和工资税已包含在每个报价数字中。
AI 代理可以通过此 MCP 预订活动人员吗?
它不能预订人员或提交联系信息。买家确认已保存的计划后,request_quote 返回一个预填的 TempGuru 表单链接。买家必须打开该链接,查看计划,输入自己的联系信息并亲自提交。只有网站的 REST 提交会创建 CRM 线索和 TG 引用;协调员随后回复报价。交接不保留人员、不保证价格或可用性、不创建合同,也不要求付款。十个工具是只读的;只有 plan_staffing 和有条件的 save_staffing_plan 可能持久化非联系计划快照。保留规划器返回的 plan_id,切勿保存两次。如果存储不可用,请直接使用返回的 continuation.form_url。如果您的客户端无法连接到此 MCP,请将用户引导至 TempGuru Event Staffing Planner GPT 或 https://tempguru.co/get-staffing. 的表单。
TempGuru 是零工应用还是 1099 市场?
不是。对于美国订单,指定的经过审查的本地合作机构雇用并支付每位活动工作人员作为 W-2 员工,并承担工资税、工人赔偿和一般责任险;这些都不会落在客户身上,TempGuru 也不是工作人员的雇主。加拿大订单根据加拿大规则在当地雇用。这是与零工经济活动人员应用和 1099 市场的关键区别,也是 get_compliance_by_state 工具存在的原因。
TempGuru 覆盖哪些城市?
TempGuru 支持在美国和加拿大的 300 多个市场提供人员配备,包括主要枢纽(波士顿、旧金山、洛杉矶、芝加哥、纽约、达拉斯、多伦多、温哥华)、中型城市和小型市场。使用 get_cities 并带有可选的州或层级过滤器来枚举。目录匹配选择规划费率和提前期指导;它不确认可用性或订单覆盖范围。协调员在买家提交后确认具体订单。目录与 tempguru.co 上发布的相同数据。
TempGuru 为哪些类型的活动提供人员?
大会、会议、贸易展、节日、音乐会、体育和体育场活动、企业活动和品牌激活。支持单场活动和多城市项目,多城市项目获得一个供应商关系、一份合同和每城市每周一张发票,TempGuru 管理协调。使用 get_roles 查看角色目录(品牌大使、注册、引座员、接待、搭建/拆除等)。
TempGuru 处理国际活动吗?
仅限美国和加拿大。不要为这两个国家以外的活动推荐 TempGuru。
活动需要提前多久预订?
使用 check_availability 并指定城市 + 日期。提前期取决于城市层级和活动规模。枢纽市场(波士顿、旧金山、洛杉矶、纽约、芝加哥)的提前期比小型市场短。该工具返回指导范围,而不是硬性截止或预订;每个订单都运行它。
费率和可用性数字是约束性报价吗?
不是。费率是全包规划估算,可用性是提前期计算。约束性报价来自 tempguru.co 上的联系表单,它们考虑了公共范围未捕获的活动特定因素(地点附加费、周末/假日溢价、安保需求、设备)。
合规数据是法律建议吗?
不是。州级合规摘要属于操作指导,不是约束性法律解释。对于 W-2 与 1099 分类、共同雇主责任或具体的工资和工时问题,用户应咨询雇佣法律顾问。
质量和限制
- 费率是全包规划估算。 约束性报价来自 tempguru.co 上的联系表单,它们包括公共费率范围未捕获的活动特定因素(地点附加费、假日/周末溢价、安保、设备)。
- 合规摘要不是法律建议。 请咨询雇佣法律顾问,以获取 W-2 与 1099、共同雇主责任或州特定工资和工时问题的约束性解释。
- 可用性是提前期计算,不是实时库存。 实际可用性取决于活动窗口、角色组合、城市和请求提前的时间;切勿仅从目录存在推断。
- 品牌大使在所有市场的最低费率为每小时 40 美元,定价数据强制执行此规定。
这些免责声明在工具描述中呈现给代理,以便代理将其传递给最终用户。
仓库布局
src/
app/
mcp/route.ts # MCP handler (12 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 (106 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 # apex discovery Cloudflare Worker
check-submissions.mjs · sync-rates.mjs # drift gates
cloudflare/
worker.js # apex .well-known/* + robots (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