---
title: "x1-hq"
description: "Operate and analyze X1 HQ through authenticated, tenant-scoped MCP workflows."
canonical: https://agentpluginsdirectory.com/plugins/x1-hq--caterlord
last-updated: 2026-09-17
---

# x1-hq
Operate and analyze X1 HQ through authenticated, tenant-scoped MCP workflows.
- Slug: x1-hq--caterlord
- Publisher: X1
- Repository: https://github.com/caterlord/X1.AgentPlugins
- Manifest: plugins/x1-hq/plugin.json
- Version: 0.8.2
- Category (editorial): other
- Skills: 5 (analyze-x1-hq-reports, import-menu-from-document, manage-tables-and-floorplans, operate-x1-hq, publish-menu-online)
- MCP servers: 1 (x1-hq)
- Stars: 0
- Repository created: 2026-09-01
- Repository last pushed: 2026-09-17
- Publisher type: Organization
- Listing: https://agentpluginsdirectory.com/plugins/x1-hq--caterlord
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What x1-hq does, in the publisher's words

X1 HQ is a conversational operating and reporting plugin for X1 merchants. The portable Agent Plugins 1.0.0 package combines shared skills with a direct Streamable HTTP connection to the hosted X1 HQ MCP gateway. It has no registered ChatGPT app dependency:

- operate-x1-hq handles everyday operational work across menus, settings, devices, online ordering, and other capabilities exposed by the gateway.
- manage-tables-and-floorplans handles dining tables and editable seating layouts.
- publish-menu-online handles online menus, photos and test QR verification.
- analyze-x1-hq-reports handles read-only reporting and investigation.
- import-menu-from-document handles resumable PDF, image, spreadsheet, CSV, and pasted-menu extraction, complete table review, explicit approval, and server-side approved commit handoff.

The skills are conversational operating guides. They contain no credentials, do not call X1 HQ APIs directly, and grant no permission. The MCP gateway is the only business-operation path and enforces authentication, workspace scope, delegated scopes, previews and approvals, quotas, audit policy, and circuit breakers.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/caterlord/X1.AgentPlugins/HEAD/plugins/x1-hq/README.md

## Skills

- analyze-x1-hq-reports: Analyze X1 HQ sales, item and category performance, payments, order details, operational exceptions, and period comparisons. Use for reporting, performance questions, trends, rankings, anomalies, investigations, and business summaries. This skill is read-only; use operate-x1-hq for any resulting me…
- import-menu-from-document: Extract, structure, validate, resume, and preview X1 HQ menu imports from PDF, image, spreadsheet, CSV, pasted text, or another customer document. Use when a customer supplies menu source material, asks an agent to enter a menu, needs multi-turn clarification, or wants to resume a document-derived…
- manage-tables-and-floorplans: Create, edit, remove, restore and inspect X1 dining tables and split tables, and build editable floorplans from uploaded hand drawings, floor plans, photos, PDFs or other customer references. Use for table lists, seating layouts, table positions and section backgrounds.
- operate-x1-hq: Perform everyday X1 HQ operations across menus, prices, availability, online ordering, shops, tables, floorplans, devices, cash drawers, and other settings exposed by the connected gateway. Use for inspecting, diagnosing, importing, creating, updating, copying, enabling, disabling, or configuring X…
- publish-menu-online: Convert an existing or just-imported X1 HQ catalog into a published online-ordering menu, optionally upload customer-facing item, category, and shop photos, configure counter, preorder, or static-table ordering for selected shops, verify the result, and show a test QR. Use after menu categories and…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- x1-hq: transport: streamable-http; url: https://mcp.x1.tech/mcp

Read from the plugin's own mcp.json. Environment variable names only, never values.