Noizu.MCP.Server.Tools.Catalog (Noizu MCP v0.1.0)

Copy Markdown View Source

Built-in catalog discovery tool.

Lets agents discover all registered MCP items, including those hidden from normal listings. Register it on a server with:

tool Noizu.MCP.Server.Tools.Catalog

or, to keep the catalog itself out of tools/list:

tool Noizu.MCP.Server.Tools.Catalog, hidden: true

Hidden items never appear in tools/list / prompts/list / resources/list responses, but remain callable by name via tools/call, prompts/get, and resources/read. The catalog gives agents the full wire definitions (including input schemas) they need to do so.

Arguments

  • type — "tools" | "prompts" | "resources" | "resource_templates" | "all" (default)

  • query — optional case-insensitive substring filter applied to name, description, and URI
  • category — optional exact (case-insensitive) match on the category label; applies only to entries that carry one (tools declared with category:), all others are dropped from the result
  • include_hidden — true (default) to include hidden items; false for visible-only

Result

Structured content with one key per requested section. Each entry is the item's full wire definition plus a "hidden" boolean; tool entries also carry a top-level "category" when one was declared:

%{
  "tools" => [%{"name" => "echo", "inputSchema" => %{...}, "hidden" => false,
                "category" => "Utility"}, ...],
  "prompts" => [...],
  "resources" => [...],
  "resource_templates" => [...]
}

Only works against servers whose registries come from the tool/prompt/ resource/resource_template DSL macros (it reads server.__mcp__/1).