cyanheads-mcp-server

Describe Fleet Tool or Server

cyanheads_describe_entry

Read-only

Return the description and install snippets for a named tool or server. For tools: the description, owning server, and connection metadata. For either kind: local (stdio, via npx) install snippets for every published server, plus remote (HTTP) connection snippets when a hosted endpoint exists — for every supported client, or one client via the client parameter.

Input Schema

TableJSON Schema

Name	Required	Description
`kind`	No	Whether name refers to a tool or server. Omit to auto-detect: names containing underscores are treated as tools; names containing hyphens are treated as servers.
`name`	Yes	Tool name (snake_case, e.g. "earthquake_search") or server name (kebab-case, e.g. "earthquake-mcp-server"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonical names. A tool name that more than one server owns also needs server. Use cyanheads_search_catalog to discover valid names.
`client`	No	Return install snippets for this client only (both local and remote transports when available). "streamable-http" selects the generic mcpServers JSON; "curl" selects a connectivity probe for hosted servers. Omit to return snippets for all supported clients.
`server`	No	Server that owns the tool to describe — the server value cyanheads_search_catalog returned with this name. 1-64 characters, resolved like a server name. Required when the tool name has more than one owner; with a server name, it must name the same server.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`error`	No	Present when the call failed. Absent on success.
`result`	No	The resolved entry — either a tool detail or a server detail depending on the resolved kind.

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedOct 19, 2026

changedInput schema / properties / client / description

Previous value: -"Return install snippets for this client only (both local and remote transports when available). Omit to return snippets for all supported clients."New value: +"Return install snippets for this client only (both local and remote transports when available). \"streamable-http\" selects the generic mcpServers JSON; \"curl\" selects a connectivity probe for hosted servers. Omit to return snippets for all supported clients."

changedInput schema / properties / client / enum

Previous value: -[
-  "claude-code",
-  "codex",
-  "cursor",
-  "curl",
-  "gemini",
-  "streamable-http"
-]New value: +[
+  "claude-code",
+  "cline",
+  "codex",
+  "cursor",
+  "curl",
+  "gemini",
+  "streamable-http"
+]

changedInput schema / properties / name / description

Previous value: -"Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonical names. Use cyanheads_search_catalog to discover valid names."New value: +"Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonical names. A tool name that more than one server owns also needs server. Use cyanheads_search_catalog to discover valid names."

addedInput schema / properties / server

Added value: +{
+  "description": "Server that owns the tool to describe — the server value cyanheads_search_catalog returned with this name. 1-64 characters, resolved like a server name. Required when the tool name has more than one owner; with a server name, it must name the same server.",
+  "maxLength": 64,
+  "minLength": 1,
+  "type": "string"
+}

changedOutput schema / properties / error / properties / data / properties / reason / description

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: No tool or server with the given name exists in the catalog. `ambiguous_kind`: Name matches both a tool and a server (collision in catalog). `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: No tool or server with the given name, under the given server when set, exists in the catalog. `ambiguous_kind`: Name matches both a tool and a server (collision in catalog). `ambiguous_owner`: The tool name has more than one owning server and server is not set. `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler."

changedOutput schema / properties / error / properties / data / properties / reason / examples

Previous value: -[
-  "not_found",
-  "ambiguous_kind",
-  "catalog_empty"
-]New value: +[
+  "not_found",
+  "ambiguous_kind",
+  "ambiguous_owner",
+  "catalog_empty"
+]

changedOutput schema / properties / result / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "description": "A resolved tool entry — its description and the server that owns it.",
-    "properties": {
-      "auth": {
-        "description": "Owning server hosted authentication requirement.",
-        "type": "string"
-      },
-      "description": {
-        "description": "Brief description of what the tool does.",
-        "type": "string"
-      },
-      "endpoint": {
-        "description": "Owning server hosted HTTP endpoint, when available.",
-        "type": "string"
-      },
-      "github": {
-        "description": "Owning server GitHub repository URL.",
-        "type": "string"
-      },
-      "installNotice": {
-        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
-        "type": "string"
-      },
-      "installSnippets": {
-        "description": "Owning server install snippets, filtered by client when supplied.",
-        "items": {
-          "additionalProperties": false,
-          "description": "An installation snippet for the owning server.",
-          "properties": {
-            "client": {
-              "description": "Target MCP client.",
-              "enum": [
-                "claude-code",
-                "codex",
-                "cursor",
-                "curl",
-                "gemini",
-                "streamable-http"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "description": "Install method label.",
-              "type": "string"
-            },
-            "payload": {
-              "description": "Install command or configuration.",
-              "type": "string"
-            },
-            "transport": {
-              "description": "Local stdio or hosted HTTP transport.",
-              "enum": [
-                "stdio",
-                "http"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "client",
-            "transport",
-            "label",
-            "payload"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "kind": {
-        "const": "tool",
-        "description": "Resolved as a tool entry.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Canonical resolved tool name.",
-        "type": "string"
-      },
-      "npm": {
-        "description": "Owning server npm package for local installation.",
-        "type": "string"
-      },
-      "requiredEnvVars": {
-        "description": "Environment variable names required for local installation.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "server": {
-        "description": "Server package name that owns this tool.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "description",
-      "server",
-      "npm",
-      "github",
-      "auth",
-      "installSnippets"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "description": "A resolved server entry — metadata, optional hosted endpoint, and per-client install snippets.",
-    "properties": {
-      "auth": {
-        "description": "Auth requirement for the hosted deployment (currently always \"none\").",
-        "type": "string"
-      },
-      "description": {
-        "description": "Brief description of what the server does.",
-        "type": "string"
-      },
-      "displayName": {
-        "description": "Human-readable server label.",
-        "type": "string"
-      },
-      "endpoint": {
-        "description": "Streamable HTTP endpoint for the hosted deployment. Absent for local-only (stdio) servers.",
-        "type": "string"
-      },
-      "github": {
-        "description": "GitHub repository URL.",
-        "type": "string"
-      },
-      "installNotice": {
-        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
-        "type": "string"
-      },
-      "installSnippets": {
-        "description": "Install instructions: local (stdio) snippets for every server, plus remote (HTTP) snippets when an endpoint exists. Filtered to one client when input.client is set.",
-        "items": {
-          "additionalProperties": false,
-          "description": "A single install instruction entry.",
-          "properties": {
-            "client": {
-              "description": "MCP client this snippet targets.",
-              "enum": [
-                "claude-code",
-                "codex",
-                "cursor",
-                "curl",
-                "gemini",
-                "streamable-http"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "description": "Human-readable install method label.",
-              "type": "string"
-            },
-            "payload": {
-              "description": "Install payload (JSON fragment or CLI command).",
-              "type": "string"
-            },
-            "transport": {
-              "description": "Transport this snippet installs — stdio (local) or http (remote).",
-              "enum": [
-                "stdio",
-                "http"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "client",
-            "transport",
-            "label",
-            "payload"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "kind": {
-        "const": "server",
-        "description": "Resolved as a server entry.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Canonical resolved server name.",
-        "type": "string"
-      },
-      "npm": {
-        "description": "npm package name (e.g. \"@cyanheads/arxiv-mcp-server\"). Drives the local stdio snippets.",
-        "type": "string"
-      },
-      "requiredEnvVars": {
-        "description": "Env var names the local (stdio) install requires (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "toolCount": {
-        "description": "Number of tools exposed by this server.",
-        "type": "number"
-      },
-      "tools": {
-        "description": "Every tool this server exposes, each with its name and a brief description — one describe call reveals the full surface without a second lookup.",
-        "items": {
-          "additionalProperties": false,
-          "description": "A single tool exposed by this server.",
-          "properties": {
-            "description": {
-              "description": "Brief description of what the tool does.",
-              "type": "string"
-            },
-            "name": {
-              "description": "Tool name (snake_case, e.g. \"earthquake_search\").",
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "description"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "version": {
-        "description": "Published version captured at fleet-generation time.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "displayName",
-      "description",
-      "version",
-      "npm",
-      "github",
-      "auth",
-      "toolCount",
-      "tools",
-      "installSnippets"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "A resolved tool entry — its description and the server that owns it.",
+    "properties": {
+      "auth": {
+        "description": "Owning server hosted authentication requirement.",
+        "type": "string"
+      },
+      "description": {
+        "description": "Brief description of what the tool does.",
+        "type": "string"
+      },
+      "endpoint": {
+        "description": "Owning server hosted HTTP endpoint, when available.",
+        "type": "string"
+      },
+      "github": {
+        "description": "Owning server GitHub repository URL.",
+        "type": "string"
+      },
+      "installNotice": {
+        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
+        "type": "string"
+      },
+      "installSnippets": {
+        "description": "Owning server install snippets, filtered by client when supplied.",
+        "items": {
+          "additionalProperties": false,
+          "description": "An installation snippet for the owning server.",
+          "properties": {
+            "client": {
+              "description": "Target MCP client.",
+              "enum": [
+                "claude-code",
+                "cline",
+                "codex",
+                "cursor",
+                "curl",
+                "gemini",
+                "streamable-http"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "description": "Install method label.",
+              "type": "string"
+            },
+            "payload": {
+              "description": "Install command or configuration.",
+              "type": "string"
+            },
+            "transport": {
+              "description": "Local stdio or hosted HTTP transport.",
+              "enum": [
+                "stdio",
+                "http"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "client",
+            "transport",
+            "label",
+            "payload"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "kind": {
+        "const": "tool",
+        "description": "Resolved as a tool entry.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Canonical resolved tool name.",
+        "type": "string"
+      },
+      "npm": {
+        "description": "Owning server npm package for local installation.",
+        "type": "string"
+      },
+      "requiredEnvVars": {
+        "description": "Environment variable names required for local installation.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "server": {
+        "description": "Server package name that owns this tool.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name",
+      "description",
+      "server",
+      "npm",
+      "github",
+      "auth",
+      "installSnippets"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A resolved server entry — metadata, optional hosted endpoint, and per-client install snippets.",
+    "properties": {
+      "auth": {
+        "description": "Auth requirement for the hosted deployment (currently always \"none\").",
+        "type": "string"
+      },
+      "description": {
+        "description": "Brief description of what the server does.",
+        "type": "string"
+      },
+      "displayName": {
+        "description": "Human-readable server label.",
+        "type": "string"
+      },
+      "endpoint": {
+        "description": "Streamable HTTP endpoint for the hosted deployment. Absent for local-only (stdio) servers.",
+        "type": "string"
+      },
+      "github": {
+        "description": "GitHub repository URL.",
+        "type": "string"
+      },
+      "installNotice": {
+        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
+        "type": "string"
+      },
+      "installSnippets": {
+        "description": "Install instructions: local (stdio) snippets for every server, plus remote (HTTP) snippets when an endpoint exists. Filtered to one client when input.client is set.",
+        "items": {
+          "additionalProperties": false,
+          "description": "A single install instruction entry.",
+          "properties": {
+            "client": {
+              "description": "MCP client this snippet targets.",
+              "enum": [
+                "claude-code",
+                "cline",
+                "codex",
+                "cursor",
+                "curl",
+                "gemini",
+                "streamable-http"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "description": "Human-readable install method label.",
+              "type": "string"
+            },
+            "payload": {
+              "description": "Install payload (JSON fragment or CLI command).",
+              "type": "string"
+            },
+            "transport": {
+              "description": "Transport this snippet installs — stdio (local) or http (remote).",
+              "enum": [
+                "stdio",
+                "http"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "client",
+            "transport",
+            "label",
+            "payload"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "kind": {
+        "const": "server",
+        "description": "Resolved as a server entry.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Canonical resolved server name.",
+        "type": "string"
+      },
+      "npm": {
+        "description": "npm package name (e.g. \"@cyanheads/arxiv-mcp-server\"). Drives the local stdio snippets.",
+        "type": "string"
+      },
+      "requiredEnvVars": {
+        "description": "Env var names the local (stdio) install requires (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "toolCount": {
+        "description": "Number of tools exposed by this server.",
+        "type": "number"
+      },
+      "tools": {
+        "description": "Every tool this server exposes, each with its name and a brief description — one describe call reveals the full surface without a second lookup.",
+        "items": {
+          "additionalProperties": false,
+          "description": "A single tool exposed by this server.",
+          "properties": {
+            "description": {
+              "description": "Brief description of what the tool does.",
+              "type": "string"
+            },
+            "name": {
+              "description": "Tool name (snake_case, e.g. \"earthquake_search\").",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "description"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "version": {
+        "description": "Published version captured at fleet-generation time.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name",
+      "displayName",
+      "description",
+      "version",
+      "npm",
+      "github",
+      "auth",
+      "toolCount",
+      "tools",
+      "installSnippets"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedSep 30, 2026

changedInput schema / properties / name / description

Previous value: -"Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Use cyanheads_search_catalog to discover valid names."New value: +"Tool name (snake_case, e.g. \"earthquake_search\") or server name (kebab-case, e.g. \"earthquake-mcp-server\"). 1-64 characters. Exact names win; unique case-insensitive names resolve to canonical names. Use cyanheads_search_catalog to discover valid names."

changedOutput schema / properties / result / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "description": "A resolved tool entry — its description and the server that owns it.",
-    "properties": {
-      "description": {
-        "description": "Brief description of what the tool does.",
-        "type": "string"
-      },
-      "kind": {
-        "const": "tool",
-        "description": "Resolved as a tool entry.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Resolved name (as looked up).",
-        "type": "string"
-      },
-      "server": {
-        "description": "Server package name that owns this tool.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "description",
-      "server"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "description": "A resolved server entry — metadata, optional hosted endpoint, and per-client install snippets.",
-    "properties": {
-      "auth": {
-        "description": "Auth requirement for the hosted deployment (currently always \"none\").",
-        "type": "string"
-      },
-      "description": {
-        "description": "Brief description of what the server does.",
-        "type": "string"
-      },
-      "displayName": {
-        "description": "Human-readable server label.",
-        "type": "string"
-      },
-      "endpoint": {
-        "description": "Streamable HTTP endpoint for the hosted deployment. Absent for local-only (stdio) servers.",
-        "type": "string"
-      },
-      "github": {
-        "description": "GitHub repository URL.",
-        "type": "string"
-      },
-      "installSnippets": {
-        "description": "Install instructions: local (stdio) snippets for every server, plus remote (HTTP) snippets when an endpoint exists. Filtered to one client when input.client is set.",
-        "items": {
-          "additionalProperties": false,
-          "description": "A single install instruction entry.",
-          "properties": {
-            "client": {
-              "description": "MCP client this snippet targets.",
-              "enum": [
-                "claude-code",
-                "codex",
-                "cursor",
-                "curl",
-                "gemini",
-                "streamable-http"
-              ],
-              "type": "string"
-            },
-            "label": {
-              "description": "Human-readable install method label.",
-              "type": "string"
-            },
-            "payload": {
-              "description": "Install payload (JSON fragment or CLI command).",
-              "type": "string"
-            },
-            "transport": {
-              "description": "Transport this snippet installs — stdio (local) or http (remote).",
-              "enum": [
-                "stdio",
-                "http"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "client",
-            "transport",
-            "label",
-            "payload"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "kind": {
-        "const": "server",
-        "description": "Resolved as a server entry.",
-        "type": "string"
-      },
-      "name": {
-        "description": "Resolved name (as looked up).",
-        "type": "string"
-      },
-      "npm": {
-        "description": "npm package name (e.g. \"@cyanheads/arxiv-mcp-server\"). Drives the local stdio snippets.",
-        "type": "string"
-      },
-      "requiredEnvVars": {
-        "description": "Env var names the local (stdio) install requires (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "toolCount": {
-        "description": "Number of tools exposed by this server.",
-        "type": "number"
-      },
-      "tools": {
-        "description": "Every tool this server exposes, each with its name and a brief description — one describe call reveals the full surface without a second lookup.",
-        "items": {
-          "additionalProperties": false,
-          "description": "A single tool exposed by this server.",
-          "properties": {
-            "description": {
-              "description": "Brief description of what the tool does.",
-              "type": "string"
-            },
-            "name": {
-              "description": "Tool name (snake_case, e.g. \"earthquake_search\").",
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "description"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "version": {
-        "description": "Published version captured at fleet-generation time.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "displayName",
-      "description",
-      "version",
-      "npm",
-      "github",
-      "auth",
-      "toolCount",
-      "tools",
-      "installSnippets"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "description": "A resolved tool entry — its description and the server that owns it.",
+    "properties": {
+      "auth": {
+        "description": "Owning server hosted authentication requirement.",
+        "type": "string"
+      },
+      "description": {
+        "description": "Brief description of what the tool does.",
+        "type": "string"
+      },
+      "endpoint": {
+        "description": "Owning server hosted HTTP endpoint, when available.",
+        "type": "string"
+      },
+      "github": {
+        "description": "Owning server GitHub repository URL.",
+        "type": "string"
+      },
+      "installNotice": {
+        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
+        "type": "string"
+      },
+      "installSnippets": {
+        "description": "Owning server install snippets, filtered by client when supplied.",
+        "items": {
+          "additionalProperties": false,
+          "description": "An installation snippet for the owning server.",
+          "properties": {
+            "client": {
+              "description": "Target MCP client.",
+              "enum": [
+                "claude-code",
+                "codex",
+                "cursor",
+                "curl",
+                "gemini",
+                "streamable-http"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "description": "Install method label.",
+              "type": "string"
+            },
+            "payload": {
+              "description": "Install command or configuration.",
+              "type": "string"
+            },
+            "transport": {
+              "description": "Local stdio or hosted HTTP transport.",
+              "enum": [
+                "stdio",
+                "http"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "client",
+            "transport",
+            "label",
+            "payload"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "kind": {
+        "const": "tool",
+        "description": "Resolved as a tool entry.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Canonical resolved tool name.",
+        "type": "string"
+      },
+      "npm": {
+        "description": "Owning server npm package for local installation.",
+        "type": "string"
+      },
+      "requiredEnvVars": {
+        "description": "Environment variable names required for local installation.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "server": {
+        "description": "Server package name that owns this tool.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name",
+      "description",
+      "server",
+      "npm",
+      "github",
+      "auth",
+      "installSnippets"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "description": "A resolved server entry — metadata, optional hosted endpoint, and per-client install snippets.",
+    "properties": {
+      "auth": {
+        "description": "Auth requirement for the hosted deployment (currently always \"none\").",
+        "type": "string"
+      },
+      "description": {
+        "description": "Brief description of what the server does.",
+        "type": "string"
+      },
+      "displayName": {
+        "description": "Human-readable server label.",
+        "type": "string"
+      },
+      "endpoint": {
+        "description": "Streamable HTTP endpoint for the hosted deployment. Absent for local-only (stdio) servers.",
+        "type": "string"
+      },
+      "github": {
+        "description": "GitHub repository URL.",
+        "type": "string"
+      },
+      "installNotice": {
+        "description": "Actionable guidance when the requested client has no compatible installation snippet.",
+        "type": "string"
+      },
+      "installSnippets": {
+        "description": "Install instructions: local (stdio) snippets for every server, plus remote (HTTP) snippets when an endpoint exists. Filtered to one client when input.client is set.",
+        "items": {
+          "additionalProperties": false,
+          "description": "A single install instruction entry.",
+          "properties": {
+            "client": {
+              "description": "MCP client this snippet targets.",
+              "enum": [
+                "claude-code",
+                "codex",
+                "cursor",
+                "curl",
+                "gemini",
+                "streamable-http"
+              ],
+              "type": "string"
+            },
+            "label": {
+              "description": "Human-readable install method label.",
+              "type": "string"
+            },
+            "payload": {
+              "description": "Install payload (JSON fragment or CLI command).",
+              "type": "string"
+            },
+            "transport": {
+              "description": "Transport this snippet installs — stdio (local) or http (remote).",
+              "enum": [
+                "stdio",
+                "http"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "client",
+            "transport",
+            "label",
+            "payload"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "kind": {
+        "const": "server",
+        "description": "Resolved as a server entry.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Canonical resolved server name.",
+        "type": "string"
+      },
+      "npm": {
+        "description": "npm package name (e.g. \"@cyanheads/arxiv-mcp-server\"). Drives the local stdio snippets.",
+        "type": "string"
+      },
+      "requiredEnvVars": {
+        "description": "Env var names the local (stdio) install requires (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "toolCount": {
+        "description": "Number of tools exposed by this server.",
+        "type": "number"
+      },
+      "tools": {
+        "description": "Every tool this server exposes, each with its name and a brief description — one describe call reveals the full surface without a second lookup.",
+        "items": {
+          "additionalProperties": false,
+          "description": "A single tool exposed by this server.",
+          "properties": {
+            "description": {
+              "description": "Brief description of what the tool does.",
+              "type": "string"
+            },
+            "name": {
+              "description": "Tool name (snake_case, e.g. \"earthquake_search\").",
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "description"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "version": {
+        "description": "Published version captured at fleet-generation time.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name",
+      "displayName",
+      "description",
+      "version",
+      "npm",
+      "github",
+      "auth",
+      "toolCount",
+      "tools",
+      "installSnippets"
+    ],
+    "type": "object"
+  }
+]

Changed6 schema fields changedAug 21, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / additionalProperties
```
Added value: +false
```

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedOutput schema / anyOf

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "result"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

addedOutput schema / properties / error

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: No tool or server with the given name exists in the catalog. `ambiguous_kind`: Name matches both a tool and a server (collision in catalog). `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found",
+            "ambiguous_kind",
+            "catalog_empty"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

removedOutput schema / required
```
Removed value: -[
-  "result"
-]
```

AddedJul 26, 2026

TDQS

A3.9/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds genuine context beyond that: it discloses that local stdio/npx snippets cover every published server while remote HTTP snippets appear only 'when a hosted endpoint exists,' and that results can be scoped to one client or all clients.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first sentence, and the second elaborates on output content. It is efficient overall, though the long em-dash-laden second sentence is somewhat run-on and packs several distinct behaviors together.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value structure need not be explained. For a read-only lookup with a required name and an auto-detection hint handled in the schema, the description covers the important behavioral surface (kind handling, client scoping, conditional remote snippets).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description's note that snippets are returned 'for every supported client, or one client via the client parameter' adds a little meaning about the client param's effect, but it largely restates what the schema already documents thoroughly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Return the description and install snippets for a named tool or server.' It then further distinguishes the two operating modes (tool vs server) so an agent knows precisely what it gets back, and it is clearly distinct from the search sibling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what is returned for each kind and how the client parameter narrows scope, which implies when to use it. However, it never explicitly names cyanheads_search_catalog as the discovery alternative or states when to prefer this tool over it; the only pointer to the sibling lives in the schema, not the description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All cyanheads-mcp-server tools Inspect

Try in Browser

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.