tag
build.type=tag, build.spec.tag=<value>
How to use it
tag is exposed by the MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the tag tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install MCP Server
claude mcp add harness -- npx harness-mcp-v2Other tools in MCP Server (21)
must be an object with a yaml field. Raw string bodies are rejected by the public harnessexecute schema.
build.type=branch, build.spec.branch=<value>
build.type=commitSha, build.spec.commitSha=<value>
the plan execution ID from resourceid.
Create a new resource. Supports inline and remote (Git-backed) pipelines. Prompts for user confirmation via elicitation.
Delete a resource. Prompts for user confirmation via elicitation. Destructive.
Discover available resource types, operations, and fields. No API call — returns local registry metadata.
Diagnose pipeline, connector, delegate, and gitopsapplication resources (aliases: execution -> pipeline, gitopsapp -> gitopsapplication). For pipelines, returns stage/step timing and failure details; for connectors/delegates/GitOps apps, returns targeted health and troubleshooting signals.
Execute an action on a resource (run/retry pipeline, import pipeline from Git, toggle flag, sync app). Prompts for user confirmation via elicitation. For pipeline runs, use the runtime-input workflow below (supports branch/tag/prnumber/commitsha shorthand expansion).
Get a single resource by its identifier.
List resources of a given type with filtering, search, and pagination.
Fetch exact YAML/JSON Schema definitions and examples for creating/updating resources. Pipeline/template schemas are bundled; connector, environment, service, secret, and infrastructure schemas are scope-aware entity schemas fetched from bundled snapshots or NG /yaml-schema. Supports deep drilling v
Search across Harness resource types with a single query. Uses semantic routing (local all-MiniLM-L6-v2 ONNX embeddings, 384-dim) to predict relevant resource types from a knowledge corpus indexed at startup — typically narrowing from ~163 types to 1–8 before scatter-gather. Falls back to full keywo
Get a real-time project health dashboard — recent executions, failure rates, and deep links.
Update an existing resource. Supports inline and remote (Git-backed) pipelines. Prompts for user confirmation via elicitation.
source branch for Git-backed input sets, or null.
contributing saved input sets as { identifier, name } pairs.
input template at execution time, or null.
merged runtime input YAML used for the run, or null.
build.type=PR, build.spec.number=<value>
expression-resolved YAML when resolveexpressions=true, otherwise usually null.