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.

MCPCursorClaudeRead toolsChart versionsOpenAPI twin

1. Discover MCP

Public endpoint (anonymous read):

https://helm.networkcat89.com/mcp

Probe index freshness and indexed versions:

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

/healthz returns indexBuiltAt, indexChartVersion (default/latest), and indexChartVersions (every version in the offline index).

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)

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

5. Chart versions (multi-version index)

The public MCP serves an offline knowledge index built from published GitHub releases. Requests do not fetch GitHub live — older and current versions are pre-indexed blobs.

List via MCP:

curl -sS https://helm.networkcat89.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_chart_versions","arguments":{}}}'

Schema for a pinned version:

curl -sS https://helm.networkcat89.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_values_schema","arguments":{"chartVersion":"0.4.3"}}}'

HTTP twin (same operationIds): GET /api/v1/chart-versions, GET /api/v1/values-schema?chartVersion=0.4.3, GET /api/v1/values/explain?path=image&chartVersion=0.4.3. See /openapi.json.

6. 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.

7. OpenAPI read twin

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

Related

Documentation hub → · Getting Started → · Chart repository →