Sets what WE say about one catalog entry — hidden, featured, official, logo —…
Sets what WE say about one catalog entry — hidden, featured, official, logo — and answers with the stored listing.
PATCH /v1/tools/catalog/{id}
| Address | https://api.hanzo.ai/v1/tools/catalog/{id} |
| Method | PATCH |
| Operation | patch_tools_catalog_by_id |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Sets what WE say about one catalog entry — hidden, featured, official, logo — and answers with the stored listing. SuperAdmin only; every other caller is refused.
Curation is the half of a catalog row a sync cannot write, and this is the only thing that writes it. The upstream half is never editable here: a description that disagreed with the publisher's would be a fork of their listing, and the next sync would silently undo it.
Request
6 fields, body application/json (required).
| Field | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | ID is the listing to curate, from the path. |
featured | body | boolean | — | Featured puts the listing on the front of the shelf, or takes it off. |
hidden | body | boolean | — | Hidden takes the listing off the org-visible shelf, or puts it back. |
id | body | string | — | ID is the listing to curate, from the path. |
logo | body | string | — | Logo is the brand mark to render, an https URL. |
official | body | boolean | — | Official overrides the derivation: setting it makes this answer FINAL, so no later sync re-derives over it. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | MCPListing | ok |
200 body — 24 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
description | body | string | — | Description is the publisher's one-line summary. |
featured | body | boolean | — | Featured puts the listing on the front of the shelf. |
hidden | body | boolean | — | Hidden keeps the listing out of the org-visible catalog. Curation: a sync never changes it. |
id | body | string | — | ID addresses the listing in a URL. It is the reverse-DNS NAME with its one slash written as an underscore — reversible, because a namespace never contains an… |
logo | body | string | — | Logo is the brand mark to render for the listing — the publisher's icon when the entry carries one, or the one an admin set. |
name | body | string | — | Name is the publisher's reverse-DNS name, e.g. |
official | body | boolean | — | Official is whether this is the vendor's OWN server rather than someone else's copy of it. |
packages | body | MCPPackage[] | — | Packages are the runnable package forms — npm, pypi, oci — each with the runtime that launches it and the transport it then speaks. |
packages[].identifier | body | string | — | Identifier is the package name or download URL. |
packages[].registry | body | string | — | Registry is where the package is fetched from: npm, pypi, oci, nuget, mcpb. |
packages[].runtime | body | string | — | Runtime is the publisher's hint for what launches it: npx, uvx, docker. |
packages[].transport | body | string | — | Transport is what the launched process speaks: usually "stdio". |
packages[].version | body | string | — | Version is the exact published package version. |
registry | body | string | — | Registry is the upstream this row was synced from. |
remotes | body | MCPRemote[] | — | Remotes are the hosted endpoints the publisher serves the server at. |
remotes[].transport | body | string | — | Transport is "streamable-http" or "sse". |
remotes[].url | body | string | — | URL is the endpoint. |
repo | body | string | — | Repo is the source repository URL, when the entry names one. |
site | body | string | — | Site is the project's homepage, when the entry names one. |
synced | body | integer | — | Synced is when this row was last confirmed against upstream, Unix seconds. |
title | body | string | — | Title is the human-readable display name, when the entry carries one. |
transports | body | string[] | — | Transports are the distinct transports this server can be reached over, sorted: some of "stdio", "streamable-http", "sse". |
vendor | body | string | — | Vendor is the namespace half of Name — the publisher, e.g. |
version | body | string | — | Version is the published version of this listing. |
Failure carries the platform error shape — see Errors.
Examples
hanzo tools catalog update <id>import { Configuration, ToolsApi } from 'hanzoai';
const api = new ToolsApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.patchToolsCatalogById({ id: 'id', featured: false, hidden: false });from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import ToolsApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = ToolsApi(client).patch_tools_catalog_by_id(id='id', featured=False, hidden=False)cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.ToolsAPI.PatchToolsCatalogById(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, tools_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = tools_api::patch_tools_catalog_by_id(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.ToolsApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new ToolsApi(client).patchToolsCatalogById();curl -X PATCH https://api.hanzo.ai/v1/tools/catalog/<id> \
-H "Authorization: Bearer $HANZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"featured": false,
"hidden": false
}'The door reaches tools through the tools tool, which names its 19 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "describe",
"arguments": {
"op": "list_mcp_servers"
}
}
}'How is this guide?