Agents

Connect an agent to chart knowledge.

Primary interface is MCP Streamable HTTP. Chart source of truth is github.com/chaser100/u-helm-chart. Discovery pointers also live in /llms.txt and /openapi.json.

1. Discover MCP

Public endpoint (anonymous read):

https://helm.networkcat89.com/mcp

Probe index freshness:

curl -sS https://helm.networkcat89.com/healthz

Handshake (JSON-RPC over HTTP POST):

curl -sS https://helm.networkcat89.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"demo","version":"0"}}}'

List tools:

curl -sS https://helm.networkcat89.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

2. Cursor `mcpServers` snippet

{
  "mcpServers": {
    "helm-networkcat89": {
      "url": "https://helm.networkcat89.com/mcp"
    }
  }
}

Paste into Cursor MCP settings (or project MCP config). No token is required for read tools. Write tools need a Bearer token supplied by your operator.

3. Claude / generic HTTP MCP

Point the client at the same URL. Transport: Streamable HTTP. Protocol version advertised by the server: 2025-06-18. Server name: helm-networkcat89.

4. Read tools (anonymous)

search_docs — search chart documentation
get_values_schema — values JSON schema
explain_value — explain a values key
list_examples / get_example — published examples
get_checklist — production checklist
list_shapes / get_shape — workload shapes
resolve_resource — resolve a helm://… URI

Resources are listed via MCP resources/list and read via resources/read (same index).

5. Write tools (Bearer required)

propose_improvement and open_feature_branch_pr create GitHub Issues / mcp/** PRs on chaser100/u-helm-chart. Without Authorization: Bearer … the server returns HTTP 401. Prefer MCP for writes; OpenAPI only documents auth-required stubs.

6. OpenAPI read twin

Non-MCP clients can use the HTTP twin described by /openapi.json. operationId values match MCP tool names. Intended paths live under /api/v1/… (same knowledge index).

Documentation hub → · Getting Started → · Chart repository →