Connect Hermetiq to your AI agent

Prerequisites

You need a Hermetiq account with access to at least one project receiving BEP events. Sign in to the dashboard before the first MCP authentication flow.

The Hermetiq AI plugin combines the remote MCP server with a Bazel and Buildbarn skill that guides the agent toward the appropriate build, cache, profile, RBE, cost, test, or infrastructure queries.

Claude Code

Add the Hermetiq plugin marketplace, then install the plugin:

/plugin marketplace add Hermetiq/hermetiq-ai-plugin
/plugin install hermetiq@hermetiq

The plugin configures the MCP server. On first use, follow the authentication flow for your Hermetiq account. Use /mcp to re-authenticate if the connection expires or is denied.

Claude Desktop

Add https://mcp.cloud-usc1.hermetiq.io under Settings → Connectors. The Hermetiq skill can also be packaged from the plugin repository and uploaded under Customize → Skills.

{
  "mcpServers": {
    "hermetiq": {
      "type": "http",
      "url": "https://mcp.cloud-usc1.hermetiq.io"
    }
  }
}

Codex

Add the remote MCP server, authenticate, and install the Hermetiq skill from the plugin repository:

codex mcp add hermetiq --url https://mcp.cloud-usc1.hermetiq.io
codex mcp login hermetiq

After installing the skill, restart Codex so it can discover the new skill files.

Available workflows

The server exposes guided prompts as well as lower-level tools. Availability can vary with the project’s data sources and server configuration.

Natural-language requests work too: “Why did my latest build slow down?”, “Show cache-miss trends for the last seven days,” or “Which targets are most expensive to execute remotely?”

Customer-managed endpoint

The plugin defaults to Hermetiq Cloud. Customer-managed deployments can point the plugin or MCP client at that deployment’s MCP endpoint.

export HERMETIQ_MCP_URL=https://mcp.hermetiq.your-domain.example

For manual clients, replace the cloud URL in the MCP configuration with the customer-managed endpoint.