Skip to main content
Glama

cyanheads-mcp-server

by io.github.cyanheads
OverviewDiscussionsAdmin

Server Details

Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
99.8% over 63 days
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
cyanheads/cyanheads-mcp-server
GitHub Stars
1
Server Listing
cyanheads-mcp-server

TDQS

A4.1/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one searches the catalog by natural language, the other retrieves details for a specific named entry. Their descriptions make the boundary explicit, and neither overlaps with the other's function.

Naming Consistency5/5

Both tool names follow the same predictable pattern: cyanheads_ prefix plus a snake_case verb_noun structure (describe_entry, search_catalog). There is no mixing of conventions and the naming is fully readable.

Tool Count3/5

Two tools is borderline for a discovery server. While search and describe cover the core read-only catalog interaction, the count is thin and lacks any additional browsing or enumeration operation.

Completeness4/5

The surface covers the essential read-only operations: natural-language search and detailed lookup with install snippets. A minor gap is the absence of a direct list-all or browse operation, though agents can likely work around this via broad search queries.

Available Tools

2 tools
cyanheads_describe_entryDescribe Fleet Tool or ServerA
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
kindNoWhether 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.
nameYesTool 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.
clientNoReturn 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.
serverNoServer 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

ParametersJSON Schema
NameRequiredDescription
errorNoPresent when the call failed. Absent on success.
resultNoThe resolved entry — either a tool detail or a server detail depending on the resolved kind.

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.

cyanheads_search_catalogSearch Fleet Tools and ServersA
Read-only
Inspect

Search fleet tools and servers by natural-language description. Returns ranked matches with brief summaries and the server each tool belongs to. Use scope "servers" to find which server handles a workflow; use the default scope "tools" to find specific tools.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of results to return (1-1000). Default 5. At most 20 per call: a larger limit returns up to 20, with a notice naming the offset to continue from when more matches follow.
queryYesNatural language search query. Describe what you want to accomplish, a workflow, or a capability area. 1-500 raw characters; surrounding whitespace is trimmed. Must contain non-whitespace text.
scopeNoWhat to search. "tools" returns individual tool matches; "servers" returns server-level matches.tools
offsetNoResult offset. Use nextOffset with the same query, scope, category, and limit; pages use the current catalog.
categoryNoFilter by catalog category. Omit to search all categories.
serversOffsetNoIndependent server roll-up offset (10 per page). Use nextServersOffset; must be zero in servers scope.

Output Schema

ParametersJSON Schema
NameRequiredDescription
capNoPer-call result cap that was applied.
errorNoPresent when the call failed. Absent on success.
scopeNoScope that was searched.
shownNoResults returned on this capped page.
noticeNoGuidance for zero matches, an exhausted result page, or a page cut to the 20-per-call cap with more matches following (names the offset to continue from). Absent otherwise.
offsetNoCurrent ranked-result offset.
resultsNoRanked matches, best first.
serversNoServer roll-up from the full match set, independent of result offset/limit. Tools scope only. Ordered by topScore desc (name-tiebroken); 10 per page starting at serversOffset. Use nextServersOffset to continue and serversTotal for the full distinct count.
truncatedNoTrue when limit exceeded the 20-per-call cap and more matches follow this page.
nextOffsetNoNext ranked-result offset, or null when exhausted.
totalCountNoTotal relevant matches before the limit was applied.
serversTotalNoTotal distinct servers in the full match set (before the cap of 10 is applied). Present only when servers is present.
serversOffsetNoCurrent server roll-up offset; tools scope only.
effectiveQueryNoThe query that was searched.
nextServersOffsetNoNext server roll-up offset, or null when exhausted; tools scope only.

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already establish that this is a read-only, non-open-world operation, and the description adds useful substance on top: ranked results, brief summaries, and server attribution per tool. It does not discuss pagination caps or rate behavior in prose, but the schema already documents the 20-per-call limit and offset continuation.

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

Conciseness5/5

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

Three tight sentences with no waste: purpose and return value first, then the scope-selection rule. Every sentence carries decision-relevant information and the most important constraint is front-loaded.

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?

With an output schema, full parameter coverage, and safety annotations, the description supplies exactly the pieces structured fields cannot: what the ranking returns and how to choose a scope. The only gap is the absence of any relationship to describe_entry, which matters for a two-tool catalog.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description earns above baseline by explaining the practical semantics of 'scope' in workflow terms rather than just restating the enum. The remaining parameters (limit, offset, category, serversOffset) are left entirely to the schema.

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

Purpose4/5

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

The description states a specific verb and resource ('Search fleet tools and servers by natural-language description') and defines the return shape ('ranked matches with brief summaries and the server each tool belongs to'). It clearly separates the two search modes internally, but never names the one sibling tool (describe_entry), so an agent gets no explicit sibling differentiation.

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

Usage Guidelines4/5

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

It gives concrete routing guidance for its most consequential choice: scope 'servers' to find which server handles a workflow, default scope 'tools' to find specific tools. It stops short of saying when to prefer describe_entry over searching, so usage is clear but not exhaustive.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • Changedcyanheads_describe_entry7 fields changed
      • 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"
+  }
+]
    • Changedcyanheads_search_catalog7 fields changed
      • changedInput schema / properties / limit / description
        Previous value: -"Maximum number of results to return (1-20). Default 5."New value: +"Maximum number of results to return (1-1000). Default 5. At most 20 per call: a larger limit returns up to 20, with a notice naming the offset to continue from when more matches follow."
      • changedInput schema / properties / limit / maximum
        Previous value: -20New value: +1000
      • addedOutput schema / properties / cap
        Added value: +{
+  "description": "Per-call result cap that was applied.",
+  "type": "number"
+}
      • changedOutput schema / properties / notice / description
        Previous value: -"Guidance for zero matches or an exhausted result page. Absent on nonempty result pages."New value: +"Guidance for zero matches, an exhausted result page, or a page cut to the 20-per-call cap with more matches following (names the offset to continue from). Absent otherwise."
      • changedOutput schema / properties / results / items / properties / server / description
        Previous value: -"Server package name that owns this tool (e.g. \"arxiv-mcp-server\"). Same as name when scope is \"servers\"."New value: +"Server package name that owns this tool (e.g. \"arxiv-mcp-server\"). Same as name when scope is \"servers\". Pass name and server to cyanheads_describe_entry to describe exactly this row."
      • addedOutput schema / properties / shown
        Added value: +{
+  "description": "Results returned on this capped page.",
+  "type": "number"
+}
      • addedOutput schema / properties / truncated
        Added value: +{
+  "description": "True when limit exceeded the 20-per-call cap and more matches follow this page.",
+  "type": "boolean"
+}
  2. 2 tool updates
    • Changedcyanheads_describe_entry2 fields changed
      • 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"
+  }
+]
    • Changedcyanheads_search_catalog13 fields changed
      • addedInput schema / properties / offset
        Added value: +{
+  "default": 0,
+  "description": "Result offset. Use nextOffset with the same query, scope, category, and limit; pages use the current catalog.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}
      • changedInput schema / properties / query / description
        Previous value: -"Natural language search query. Describe what you want to accomplish, a workflow, or a capability area. 1-500 characters."New value: +"Natural language search query. Describe what you want to accomplish, a workflow, or a capability area. 1-500 raw characters; surrounding whitespace is trimmed. Must contain non-whitespace text."
      • addedInput schema / properties / query / pattern
        Added value: +"\\S"
      • addedInput schema / properties / serversOffset
        Added value: +{
+  "default": 0,
+  "description": "Independent server roll-up offset (10 per page). Use nextServersOffset; must be zero in servers scope.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}
      • changedOutput schema / anyOf
        Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "results",
-      "scope",
-      "effectiveQuery",
-      "totalCount"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "offset",
+      "nextOffset",
+      "results",
+      "scope",
+      "effectiveQuery",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
      • changedOutput schema / properties / error / properties / data / properties / reason / description
        Previous value: -"Machine-readable failure mode. Declared by this tool: `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: `invalid_servers_offset`: A nonzero serversOffset is supplied in servers scope. `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: -[
-  "catalog_empty"
-]New value: +[
+  "invalid_servers_offset",
+  "catalog_empty"
+]
      • addedOutput schema / properties / nextOffset
        Added value: +{
+  "description": "Next ranked-result offset, or null when exhausted.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
      • addedOutput schema / properties / nextServersOffset
        Added value: +{
+  "description": "Next server roll-up offset, or null when exhausted; tools scope only.",
+  "type": [
+    "number",
+    "null"
+  ]
+}
      • changedOutput schema / properties / notice / description
        Previous value: -"Guidance when no results matched — e.g. how to broaden the query or try a different scope. Absent on successful result pages."New value: +"Guidance for zero matches or an exhausted result page. Absent on nonempty result pages."
      • addedOutput schema / properties / offset
        Added value: +{
+  "description": "Current ranked-result offset.",
+  "type": "number"
+}
      • changedOutput schema / properties / servers / description
        Previous value: -"Roll-up of distinct servers across the full match set, before the limit slice. Present only for scope \"tools\". Ordered by topScore desc (name-tiebroken); capped at 10. Use serversTotal to see how many distinct servers matched in total."New value: +"Server roll-up from the full match set, independent of result offset/limit. Tools scope only. Ordered by topScore desc (name-tiebroken); 10 per page starting at serversOffset. Use nextServersOffset to continue and serversTotal for the full distinct count."
      • addedOutput schema / properties / serversOffset
        Added value: +{
+  "description": "Current server roll-up offset; tools scope only.",
+  "type": "number"
+}
  3. 2 tool updates
    • Changedcyanheads_describe_entry6 fields changed
      • 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"
-]
    • Changedcyanheads_search_catalog6 fields changed
      • 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": [
+      "results",
+      "scope",
+      "effectiveQuery",
+      "totalCount"
+    ]
+  },
+  {
+    "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: `catalog_empty`: Catalog has not finished loading. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "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: -[
-  "results",
-  "scope",
-  "effectiveQuery",
-  "totalCount"
-]
  4. 4 tool updates
    • Removedcyanheads_describe
    • Addedcyanheads_describe_entry
    • Removedcyanheads_search
    • Addedcyanheads_search_catalog
  5. 1 tool update
    • Changedcyanheads_describe1 field changed
      • 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"
-      },
-      "version": {
-        "description": "Published version captured at fleet-generation time.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "displayName",
-      "description",
-      "version",
-      "npm",
-      "github",
-      "auth",
-      "toolCount",
-      "installSnippets"
-    ],
-    "type": "object"
-  }
-]New 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"
+  }
+]
  6. 1 tool update
    • Changedcyanheads_describe2 fields changed
      • changedInput schema / properties / client / description
        Previous value: -"Return the install snippet for this specific client only. Omit to return snippets for all supported clients."New value: +"Return install snippets for this client only (both local and remote transports when available). Omit to return snippets for all supported clients."
      • changedOutput schema / properties / result / oneOf
        Previous value: -[
-  {
-    "additionalProperties": false,
-    "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,
-    "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.",
-        "type": "string"
-      },
-      "github": {
-        "description": "GitHub repository URL.",
-        "type": "string"
-      },
-      "installSnippets": {
-        "description": "Install instructions, one per supported client (or filtered by input.client).",
-        "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"
-            }
-          },
-          "required": [
-            "client",
-            "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\").",
-        "type": "string"
-      },
-      "toolCount": {
-        "description": "Number of tools exposed by this server.",
-        "type": "number"
-      },
-      "version": {
-        "description": "Published version captured at fleet-generation time.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name",
-      "displayName",
-      "description",
-      "version",
-      "npm",
-      "github",
-      "endpoint",
-      "auth",
-      "toolCount",
-      "installSnippets"
-    ],
-    "type": "object"
-  }
-]New 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"
+      },
+      "version": {
+        "description": "Published version captured at fleet-generation time.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name",
+      "displayName",
+      "description",
+      "version",
+      "npm",
+      "github",
+      "auth",
+      "toolCount",
+      "installSnippets"
+    ],
+    "type": "object"
+  }
+]
  7. 1 tool update
    • Changedcyanheads_search2 fields changed
      • addedOutput schema / properties / servers
        Added value: +{
+  "description": "Roll-up of distinct servers across the full match set, before the limit slice. Present only for scope \"tools\". Ordered by topScore desc (name-tiebroken); capped at 10. Use serversTotal to see how many distinct servers matched in total.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A server roll-up entry.",
+    "properties": {
+      "brief": {
+        "description": "One-line description of what the server does.",
+        "type": "string"
+      },
+      "category": {
+        "description": "Catalog category.",
+        "enum": [
+          "research",
+          "government",
+          "public-data",
+          "utility"
+        ],
+        "type": "string"
+      },
+      "matchedTools": {
+        "description": "Count of this server's tools in the full match set.",
+        "type": "number"
+      },
+      "name": {
+        "description": "Server package name (e.g. \"cdc-health-mcp-server\").",
+        "type": "string"
+      },
+      "topScore": {
+        "description": "Best cosine similarity among this server's matched tools. Drives ordering. Distinct from the score a server gets under scope \"servers\".",
+        "type": "number"
+      }
+    },
+    "required": [
+      "name",
+      "brief",
+      "category",
+      "matchedTools",
+      "topScore"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}
      • addedOutput schema / properties / serversTotal
        Added value: +{
+  "description": "Total distinct servers in the full match set (before the cap of 10 is applied). Present only when servers is present.",
+  "type": "number"
+}
  8. 1 tool update
    • Changedcyanheads_search6 fields changed
      • addedOutput schema / properties / effectiveQuery
        Added value: +{
+  "description": "The query that was searched.",
+  "type": "string"
+}
      • addedOutput schema / properties / notice
        Added value: +{
+  "description": "Guidance when no results matched — e.g. how to broaden the query or try a different scope. Absent on successful result pages.",
+  "type": "string"
+}
      • removedOutput schema / properties / query
        Removed value: -{
-  "description": "The query that was searched.",
-  "type": "string"
-}
      • addedOutput schema / properties / totalCount
        Added value: +{
+  "description": "Total relevant matches before the limit was applied.",
+  "type": "number"
+}
      • removedOutput schema / properties / totalMatched
        Removed value: -{
-  "description": "Total relevant matches before the limit was applied.",
-  "type": "number"
-}
      • changedOutput schema / required
        Previous value: -[
-  "results",
-  "totalMatched",
-  "query",
-  "scope"
-]New value: +[
+  "results",
+  "scope",
+  "effectiveQuery",
+  "totalCount"
+]
  9. 2 tool updates
    • First observedcyanheads_describe
    • First observedcyanheads_search

Related MCP Connectors

Related MCP Servers

  • MCPfinder by mcpfinder

    MCPfinderofficial

    mcpfinder
    A
    license
    Not graded
    quality
    A
    maintenance
    AI-first MCP server discovery tool that enables agents to search, inspect, and install MCP servers from multiple registries.
    13
    AGPL 3.0

  • codebase-copilot

    yashharkawat
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables MCP-based hybrid semantic code search over repositories, providing tools for searching code by meaning or keyword, retrieving symbol definitions, finding usages, reading chunks, and listing indexed repos.
    MIT

  • jevgrep

    nassim-arifette
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables semantic code search across repositories via MCP, returning exact source excerpts with paths and line numbers.
    15 npm
    104
    MIT
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.

Resources