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 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)
search_docs— search chart documentationlist_chart_versions— list every indexed chart version + default/latestget_values_schema— values JSON schema (optionalchartVersion)explain_value— explain a values key (optionalchartVersion)list_examples/get_example— published examplesget_checklist— production checklistlist_shapes/get_shape— workload shapesresolve_resource— resolve ahelm://…URI
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.
- Default = latest — omit
chartVersiononget_values_schema/explain_valueto usedefaultChart.version(same as/healthz.indexChartVersion). - List versions — call MCP tool
list_chart_versions(optionalchartName; defaults toapplication). Response fields:defaultVersion,defaultChannel,versions[]withversion,channel,isDefault. - Select a version — pass
chartVersion(semver withoutv, e.g.0.4.3) toget_values_schemaorexplain_value. OptionalchartChanneldefaults topublished. - Unknown version — returns a clear
not founderror listing indexed versions.
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 →