TempGuru Event Staffing

TempGuru MCP

面向美国和加拿大 300 多个市场的 W-2 活动人员配备 MCP 服务，依托 5,000 多场活动和 100,000 多个已完成班次。每笔订单的可用情况均需确认。共提供 12 个工具，包括 10 个只读工具（其中包含一个不收集个人身份信息的报价表单交接工具）和 2 个非破坏性、非联系类计划持久化工具。

端点： 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 Agent 查询我们配置的市场目录、费率、基于等级的提前期指南和各州合规摘要。目录匹配结果不代表已确认的订单覆盖范围或实时库存；买家提交订单后，协调员会确认具体订单。本服务是对 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	规划器元工具，应首先调用。将活动需求（城市、日期、岗位和人数）转换为完整方案，并可能自动保存一份保留 30 天、不含个人身份信息的快照，其中包含 plan_id。
save_staffing_plan	根据限定范围内的活动输入重新计算费率和总额后，显式保存完整方案。仅在尚无 plan_id 且持久化有用时使用。
get_plan	恢复由 plan_staffing 或 save_staffing_plan 保存、保留 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	只读、不含个人身份信息的买家移交流程。解析已保存的 plan_id 并返回由 TempGuru 持有的预填 form_url；不接受任何联系信息，也不会创建 CRM 潜在客户或报价参考编号。

十个工具声明了 readOnlyHint: true，包括幂等的 request_quote 移交操作。plan_staffing 和 save_staffing_plan 是唯一会写入数据的工具；两者都只执行非破坏性、非联系信息的方案持久化操作，且 readOnlyHint: false。因此，该连接器被归类为读/写，尽管它从不写入联系信息。该服务还提供 8 个技能资源和两个引导式提示词模板（plan-event-staffing、staffing-compliance-brief）。

阶段 A：规划和保存工作流

1. 首先调用 plan_staffing，提供活动城市、日期、岗位和人数。
2. 如果完整方案包含 plan_id，请保留该 ID，不要调用 save_staffing_plan；规划器已保存快照。
3. 如果完整方案没有 plan_id，且需要可恢复或可分享的内容，则使用相同的已确认活动输入调用一次 save_staffing_plan。
4. 买家确认已保存的方案并要求继续后，使用其必填的 plan_id 和可选的允许列表归因参数（source_platform、skill_id、skill_version）调用 request_quote。
5. 将返回的 form_url 提供给买家。买家必须打开该链接、查看方案、输入自己的联系信息，并亲自提交。只有通过该网站/REST 提交，才会创建潜在客户和 TG 参考编号。
6. 如果存储结果没有返回 plan_id，请勿调用 request_quote；直接将完整方案中的 continuation.form_url 提供给买家。

---

知识层（开放知识格式）

上述工具属于操作层，用于规划、定价、检查合规性，以及准备由买方操作的报价表单交接。同一数据也以知识层的形式发布：一个静态的 开放知识格式（OKF v0.1）套件，Agent 和 Google Cloud Knowledge Catalog 可以直接读取或导入，而无需抓取网页。

资源	URL
OKF 套件根目录	/okf/index.md
可下载的 tarball	/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 支持的工具。 [email protected] 已发布、为当前版本且不可变；下方未指定版本的安装命令会解析为 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 token，因此不要将 TempGuru 无需身份验证的远程 MCP 添加到 Prime 设置中。Prime 中仍无法使用仅限 MCP 的三项操作（plan_staffing、save_staffing_plan 和 get_rate_benchmark），需等待原生适配器实现功能对等。请参阅 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() 传递给任意 Agent

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 上的实时数据）

---

客户端兼容性

客户端 / Agent 运行时	状态	备注
Claude.ai (web)	✅ 已验证	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	✅ 已通过已发布制品的功能冒烟测试	使用相同的 [email protected] 包契约：8 个技能 + 9 个原生工具，并自动归因 source=prime-agent；其自带的 MCP 集成目前尚无法连接此无认证服务
OpenAI Agents SDK	✅ 兼容	使用 MCP 客户端连接上述 URL
ChatGPT (Codex / Custom GPTs with MCP)	✅ 兼容	与 OpenAI Agents SDK 相同
Qwen-Agent / DashScope / ModelScope	✅ 兼容	Qwen-Agent 的 MCPManager 可直接接受 streamable-HTTP URL
DeepSeek (via DeepSeek-MCP or OpenAI-style tool use)	✅ 兼容	支持远程 MCP 的任何客户端
Gemini (with MCP support)	✅ 兼容	符合规范的 streamable HTTP

此矩阵表示“服务符合规范；任何符合规范的客户端都可连接”。表中标注“已验证”的项目，表示我们已在实时会话中确认；标注“兼容”的项目，表示协议可确保其兼容，但我们尚未在该特定客户端中进行端到端冒烟测试。

---

架构

• 运行时： Vercel Fluid Compute 上的 Next.js 16 App Router
• MCP 处理程序： 官方 @modelcontextprotocol/server v2.0.0 双时代入口
• 传输： MCP 2026-07-28 按请求使用 HTTP，同时兼容无状态的 2025 时代 initialize/Streamable HTTP；根据需要返回 JSON 或 SSE 响应
• 身份验证： 无。数据为公开数据。
• 事实来源： content/mcp-data/ 中的 JSON 文件（城市、角色、角色定价、州／省合规信息、预订政策）
• 身份验证： tempguru.co 顶级域名上的 DNS TXT 记录包含 Ed25519 公钥，可授权在官方 MCP Registry 的 co.tempguru 命名空间下发布
• 知识层： 同一数据也会以静态 Open Knowledge Format（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；此代码库只会生成托管于 MCP 的独立导出文件，并放在 public/ 中。
• 漂移检查： npm run check:submissions（CI）和 npm run check-rates 可确保注册表／目录文件与费率数据和权威来源保持同步

公开的 REST 接口位于 mcp.tempguru.co/api/v1/*，提供 /openapi.json 中的 OpenAPI 3.1 规范和 /.well-known/api-catalog 中的 RFC 9727 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 / 等）、成功 / 错误状态、国家代码和规范化参数标识（城市 / 角色 / 州）。系统会存储每日汇总数据和有界的近期事件环形缓冲区；不会存储原始 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 Agent 能通过此 MCP 预订活动工作人员吗？

不能。它无法预订工作人员或提交联系信息。买家确认已保存的方案后，request_quote 会返回预填的 TempGuru 表单链接。买家必须打开该链接、查看方案、填写自己的联系信息并亲自提交。只有通过网站的 REST 提交才会创建 CRM 线索和 TG 参考编号；随后由协调员回复报价。此转交流程不会预留工作人员、保证价格或供应情况、创建合同，也不要求付款。十个工具为只读工具；只有 plan_staffing 和有条件调用的 save_staffing_plan 可能会保存非联系信息的方案快照。请保留规划器返回的 plan_id，切勿重复保存。如果存储不可用，请直接使用返回的 continuation.form_url。如果你的客户端无法连接到此 MCP，请引导用户使用 TempGuru 活动人员配置规划器 GPT 或访问 https://tempguru.co/get-staffing 上的表单。

TempGuru 是零工应用还是 1099 人员市场吗？

不是。在美国订单中，受派的本地合作机构会雇用每一位经过审核的活动工作人员，并按 W-2 员工方式向其支付工资，同时承担工资税、工伤赔偿和一般责任险；这些费用都不会转嫁给客户，而且 TempGuru 不是工作人员的雇主。加拿大订单则按照加拿大法规在当地雇用工作人员。这就是 TempGuru 与零工经济活动人员配置应用和 1099 人员市场之间的关键区别，也是 get_compliance_by_state 工具存在的原因。

TempGuru 覆盖哪些城市？

TempGuru 支持在美国和加拿大的 300 多个市场配备人员，包括主要枢纽（Boston、San Francisco、Los Angeles、Chicago、New York、Dallas、Toronto、Vancouver）、中型城市和小型市场。使用 get_cities，并可选择按州或层级筛选以列出城市。目录匹配会选取规划费率和提前期参考；这并不确认是否有空档或是否承接订单。买家提交后，协调人员会确认具体订单。目录与 tempguru.co 上发布的数据相同。

TempGuru 为哪些类型的活动配备人员？

会议、大会、贸易展、节庆活动、音乐会、体育赛事和体育场活动、企业活动以及品牌推广活动。支持单场活动和多城市项目。多城市项目可为每个城市的每周服务安排一个供应商关系、一份合同和一张发票，由 TempGuru 负责协调。使用 get_roles 查看职位目录（品牌大使、登记接待、引导员、接待服务、搭建/拆除等）。

TempGuru 承接国际活动吗？

仅限美国和加拿大。请勿推荐 TempGuru 承接这两个国家以外的活动。

活动需要提前多久预订？

使用 check_availability 并提供城市和日期。提前期取决于城市层级和活动规模。枢纽市场（Boston、SF、LA、NYC、Chicago）的提前期短于小型市场。该工具返回的是参考范围，而非硬性截止日期或预留；每笔订单都要查询。

费率和可用性数字是有约束力的报价吗？

不是。费率是全包式规划估算，可用性则根据提前期计算。有约束力的报价需通过 tempguru.co 上的联系表单获取；报价会考虑特定活动因素（地点附加费、周末/节假日溢价、安保需求、设备），这些因素不在公开费率范围内。

合规数据属于法律建议吗？

不是。州级合规摘要是运营指导，并非有约束力的法律解释。对于 W-2 与 1099 分类、共同雇主责任或具体的工资和工时问题，用户应咨询劳动法律顾问。

---

质量与限制

• 费率是全包式规划估算。 有约束力的报价需通过 tempguru.co 上的联系表单获取；报价会包含特定活动因素（地点附加费、节假日/周末溢价、安保、设备），这些因素不在公开费率范围内。
• 合规摘要不是法律建议。 对于 W-2 与 1099 的有约束力解释、共同雇主责任或州特定的工资和工时问题，请咨询劳动法律顾问。
• 可用性是根据提前期计算的，并非实时库存。 实际可用性取决于活动时间、职位组合、城市以及距离活动还有多久；切勿仅凭目录中有记录就推断可用。
• 所有市场的品牌大使时薪均不低于 40 美元，定价数据会强制执行这一标准。

这些免责声明会显示在工具说明中，供 Agent 转达给最终用户。

---

存储库布局

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.），[email protected]