Skip to content

Commit 21905e7

Browse files
reyortiz3claude
andauthored
Update docs for ToolHive v0.16.0 (#687)
* Update docs for ToolHive v0.16.0 - Add thv skill builds and thv skill builds remove guide content to skills-management.mdx with example output and CLI reference link - Fix MCPOIDCConfig status column name READY → VALID in auth-k8s.mdx (breaking change in v0.16.0: condition type renamed for consistency) - Document MCPServerEntry CRD in K8s intro with note that controller ships in a future release - Clarify VirtualMCPServer Redis session storage enables cross-pod restore and survives pod restarts Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Address PR review feedback Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Fix Prettier formatting in intro.mdx --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent b900326 commit 21905e7

File tree

4 files changed

+53
-8
lines changed

4 files changed

+53
-8
lines changed

docs/toolhive/guides-cli/skills-management.mdx

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -301,6 +301,50 @@ authenticated before pushing.
301301

302302
:::
303303

304+
## List and remove locally-built skill artifacts
305+
306+
After building skills locally, you can view and manage the artifacts stored in
307+
your local OCI store.
308+
309+
### List locally-built artifacts
310+
311+
```bash
312+
thv skill builds
313+
```
314+
315+
This lists all OCI skill artifacts built locally with `thv skill build`. The
316+
output shows the tag, digest, name, and version of each artifact:
317+
318+
```text
319+
TAG DIGEST NAME VERSION
320+
ghcr.io/my-org/skills/my-skill:v1.0.0 sha256:a1b2c3d4... my-skill 1.0.0
321+
my-skill:latest sha256:e5f6a7b8... my-skill
322+
```
323+
324+
For JSON output:
325+
326+
```bash
327+
thv skill builds --format json
328+
```
329+
330+
### Remove a locally-built artifact
331+
332+
To remove an artifact from the local OCI store:
333+
334+
```bash
335+
thv skill builds remove <TAG>
336+
```
337+
338+
For example:
339+
340+
```bash
341+
thv skill builds remove my-skill:latest
342+
```
343+
344+
This removes the artifact and cleans up its blobs from the local store. If
345+
multiple tags share the same digest, the blobs are retained until all tags
346+
pointing to that digest are removed.
347+
304348
## Next steps
305349

306350
- [Configure your AI client](./client-configuration.mdx) to register clients

docs/toolhive/guides-k8s/auth-k8s.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,7 @@ Check the MCPOIDCConfig status:
187187
kubectl get mcpoidc -n toolhive-system
188188
```
189189

190-
The `REFERENCES` column shows which workloads use this config. The `READY`
190+
The `REFERENCES` column shows which workloads use this config. The `VALID`
191191
column confirms validation passed.
192192

193193
### Benefits of MCPOIDCConfig

docs/toolhive/guides-k8s/intro.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ quickly using a local kind cluster. Try it out and
2121
The operator introduces new Custom Resource Definitions (CRDs) into your
2222
Kubernetes cluster. The primary CRDs for MCP server workloads are `MCPServer`,
2323
which represents a single MCP server running in Kubernetes, `MCPRemoteProxy`,
24-
which represents an MCP server running outside the cluster that is proxied by
25-
ToolHive, and `VirtualMCPServer`, which represents a virtual MCP server gateway
26-
that aggregates multiple backend MCP servers.
24+
which represents an MCP server hosted outside the cluster that ToolHive proxies,
25+
`VirtualMCPServer`, which aggregates multiple backend MCP servers behind a
26+
single endpoint.
2727

2828
All ToolHive CRDs are registered under the `toolhive` category, so you can list
2929
every ToolHive resource in your cluster with a single command:
@@ -67,8 +67,8 @@ or Gateway. To learn how to expose your MCP servers and connect clients, see
6767

6868
## Which resource type should I use?
6969

70-
The operator introduces three resource types for MCP workloads. Choose based on
71-
where your MCP server runs and how many servers you need to manage:
70+
The operator introduces resource types for MCP workloads. Choose based on where
71+
your MCP server runs and how many servers you need to manage:
7272

7373
| Resource | Use when |
7474
| -------------------- | ----------------------------------------------------------------------------------------------------------------- |

docs/toolhive/guides-vmcp/scaling-and-performance.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,9 @@ kubectl autoscale deployment vmcp-<VMCP_NAME> -n <NAMESPACE> \
6767
### Session storage for multi-replica deployments
6868

6969
When running multiple replicas, configure Redis session storage so that sessions
70-
are shared across pods. Without session storage, a request routed to a different
71-
replica than the one that established the session will fail.
70+
are shared across pods and survive pod restarts. Without session storage, a
71+
request routed to a different replica than the one that established the session
72+
will fail, and sessions are lost when pods restart.
7273

7374
```yaml title="VirtualMCPServer resource"
7475
spec:

0 commit comments

Comments
 (0)