Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.
Scored across 2 tools
The two tools have clearly distinct roles: search_catalog finds matching tools or servers by description, while describe_entry returns detailed metadata and install snippets for a named entry. An agent can easily choose search first for discovery and describe for details.
Both names use the same server prefix and a consistent verb_noun snake_case pattern: cyanheads_search_catalog and cyanheads_describe_entry. The convention is predictable throughout.
Two tools is slightly below the typical 3-15 range, but the server has a narrow catalog-lookup purpose. Search plus describe form a reasonable minimal pair, with each tool earning its place.
The surface covers the core workflow of discovering catalog entries and retrieving their descriptions/install snippets. Minor gaps exist, such as explicit listing or browsing without a search query, but agents can work around them.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| 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_events") 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. |
| Name | Required | Description |
|---|---|---|
| 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. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=false, so the safe-read profile is covered. The description adds real context beyond that: what is returned per kind, and that remote HTTP snippets appear only when a hosted endpoint exists. No contradiction with annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the core action, then two scoped clauses for tool vs either-kind output. Dense but every clause carries information; the em-dash clause is slightly long but not padded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema, full param descriptions, and read-only annotations, the description only needs to frame scope and it does: both entity kinds, local vs remote snippets, all-client vs single-client. An agent can call it correctly without further context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the enum values, auto-detection rules, and ambiguity resolution are already documented. The description restates the client default ('every supported client, or one client via the client parameter') but adds no semantics the schema lacks. Baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('Return the description and install snippets for a named tool or server') and splits behavior by entity kind (tool vs server). It never names the sibling search_catalog, so the boundary between lookup and discovery is left implicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is only implied: describing an entry after you know its name. It does not say 'use cyanheads_search_catalog first to find the name' in the description (that guidance lives only in the schema), and it states no exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 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. | |
| query | Yes | 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. | |
| scope | No | What to search. "tools" returns individual tool matches; "servers" returns server-level matches. | tools |
| offset | No | Result offset. Use nextOffset with the same query, scope, category, and limit; pages use the current catalog. | |
| category | No | Filter by catalog category. Omit to search all categories. Categories are catalog labels, not publisher types (a federal agency API can be public-data), and a wrong guess silently drops the matching server, so set this only when the category is known. | |
| serversOffset | No | Independent server roll-up offset (10 per page). Use nextServersOffset; must be zero in servers scope. |
| Name | Required | Description |
|---|---|---|
| cap | No | Per-call result cap that was applied. |
| error | No | Present when the call failed. Absent on success. |
| scope | No | Scope that was searched. |
| shown | No | Results returned on this capped page. |
| notice | No | 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. |
| offset | No | Current ranked-result offset. |
| results | No | Ranked matches, best first. |
| servers | No | 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. |
| truncated | No | True when limit exceeded the 20-per-call cap and more matches follow this page. |
| nextOffset | No | Next ranked-result offset, or null when exhausted. |
| totalCount | No | Total relevant matches before the limit was applied. |
| serversTotal | No | Total distinct servers in the full match set (before the cap of 10 is applied). Present only when servers is present. |
| serversOffset | No | Current server roll-up offset; tools scope only. |
| effectiveQuery | No | The query that was searched. |
| nextServersOffset | No | Next server roll-up offset, or null when exhausted; tools scope only. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered structurally. The description adds the ranked-summary return shape, but says nothing about result caps, pagination continuation, or the server roll-up that the schema's limit/offset descriptions allude to. With annotations present the bar is lower, but this is thin added context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, front-loaded with the action and the return shape, then the scope guidance. No filler, no restatement of the name or title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return values need no explanation, and the annotations cover read-only semantics. What remains unaddressed is pagination and the 20-per-call cap, but those are documented thoroughly in the schema's limit/offset descriptions, so an agent can still call this correctly. Near-complete for a six-parameter search tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
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 that by explaining the practical meaning of the 'scope' parameter (find a workflow owner vs. find a specific tool) rather than repeating the enum's own wording. The other five parameters, including the category filter and pagination behavior, are left entirely to the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Search fleet tools and servers by natural-language description') and describes the return shape ('ranked matches with brief summaries and the server each tool belongs to'). It implicitly distinguishes itself from the describe sibling by offering brief summaries rather than full entries, but never names cyanheads_describe_entry, so the separation is inferred rather than stated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives explicit scope-selection guidance: 'servers' to locate which server handles a workflow, default 'tools' to find specific tools. That is a genuine use-case routing decision rather than a restatement of the enum. It stops short of saying when to search versus when to call the sibling describe tool for detail.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
cyanheads_describe_entry1 field changedOutput schema / properties / result / oneOfPrevious 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_events\").",
- "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 the owning server's manifest marks required for a local install; a key the manifest leaves optional is not listed.",
+ "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 server's manifest marks required for a local (stdio) install (e.g. [\"MAILCHIMP_API_KEY\"]). Absent when none. A key the manifest leaves optional, such as one only some tools need, is not listed, so check the README before treating a local install as keyless.",
+ "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_events\").",
+ "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"
+ }
+]cyanheads_search_catalog1 field changedInput schema / properties / category / descriptionPrevious value: -"Filter by catalog category. Omit to search all categories."New value: +"Filter by catalog category. Omit to search all categories. Categories are catalog labels, not publisher types (a federal agency API can be public-data), and a wrong guess silently drops the matching server, so set this only when the category is known."cyanheads_describe_entry2 fields changedInput schema / properties / name / descriptionPrevious 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."New value: +"Tool name (snake_case, e.g. \"earthquake_search_events\") 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."Output schema / properties / result / oneOfPrevious 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"
- }
-]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_events\").",
+ "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"
+ }
+]cyanheads_describe_entry7 fields changedInput schema / properties / client / descriptionPrevious 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."Input schema / properties / client / enumPrevious value: -[
- "claude-code",
- "codex",
- "cursor",
- "curl",
- "gemini",
- "streamable-http"
-]New value: +[
+ "claude-code",
+ "cline",
+ "codex",
+ "cursor",
+ "curl",
+ "gemini",
+ "streamable-http"
+]Input schema / properties / name / descriptionPrevious 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."Input schema / properties / serverAdded 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"
+}Output schema / properties / error / properties / data / properties / reason / descriptionPrevious 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."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "not_found",
- "ambiguous_kind",
- "catalog_empty"
-]New value: +[
+ "not_found",
+ "ambiguous_kind",
+ "ambiguous_owner",
+ "catalog_empty"
+]Output schema / properties / result / oneOfPrevious 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"
+ }
+]cyanheads_search_catalog7 fields changedInput schema / properties / limit / descriptionPrevious 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."Input schema / properties / limit / maximumPrevious value: -20New value: +1000Output schema / properties / capAdded value: +{
+ "description": "Per-call result cap that was applied.",
+ "type": "number"
+}Output schema / properties / notice / descriptionPrevious 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."Output schema / properties / results / items / properties / server / descriptionPrevious 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."Output schema / properties / shownAdded value: +{
+ "description": "Results returned on this capped page.",
+ "type": "number"
+}Output schema / properties / truncatedAdded value: +{
+ "description": "True when limit exceeded the 20-per-call cap and more matches follow this page.",
+ "type": "boolean"
+}cyanheads_describe_entry2 fields changedInput schema / properties / name / descriptionPrevious 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."Output schema / properties / result / oneOfPrevious 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"
+ }
+]cyanheads_search_catalog13 fields changedInput schema / properties / offsetAdded 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"
+}Input schema / properties / query / descriptionPrevious 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."Input schema / properties / query / patternAdded value: +"\\S"Input schema / properties / serversOffsetAdded 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"
+}Output schema / anyOfPrevious 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"
+ ]
+ }
+]Output schema / properties / error / properties / data / properties / reason / descriptionPrevious 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."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "catalog_empty"
-]New value: +[
+ "invalid_servers_offset",
+ "catalog_empty"
+]Output schema / properties / nextOffsetAdded value: +{
+ "description": "Next ranked-result offset, or null when exhausted.",
+ "type": [
+ "number",
+ "null"
+ ]
+}Output schema / properties / nextServersOffsetAdded value: +{
+ "description": "Next server roll-up offset, or null when exhausted; tools scope only.",
+ "type": [
+ "number",
+ "null"
+ ]
+}Output schema / properties / notice / descriptionPrevious 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."Output schema / properties / offsetAdded value: +{
+ "description": "Current ranked-result offset.",
+ "type": "number"
+}Output schema / properties / servers / descriptionPrevious 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."Output schema / properties / serversOffsetAdded value: +{
+ "description": "Current server roll-up offset; tools scope only.",
+ "type": "number"
+}cyanheads_describe_entry6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "result"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded 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"
+}Output schema / requiredRemoved value: -[
- "result"
-]cyanheads_search_catalog6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "results",
+ "scope",
+ "effectiveQuery",
+ "totalCount"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded 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"
+}Output schema / requiredRemoved value: -[
- "results",
- "scope",
- "effectiveQuery",
- "totalCount"
-]cyanheads_describecyanheads_describe_entrycyanheads_searchcyanheads_search_catalogcyanheads_describe1 field changedOutput schema / properties / result / oneOfPrevious 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"
+ }
+]cyanheads_describe2 fields changedInput schema / properties / client / descriptionPrevious 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."Output schema / properties / result / oneOfPrevious 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"
+ }
+]cyanheads_search2 fields changedOutput schema / properties / serversAdded 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"
+}Output schema / properties / serversTotalAdded 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"
+}cyanheads_search6 fields changedOutput schema / properties / effectiveQueryAdded value: +{
+ "description": "The query that was searched.",
+ "type": "string"
+}Output schema / properties / noticeAdded 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"
+}Output schema / properties / queryRemoved value: -{
- "description": "The query that was searched.",
- "type": "string"
-}Output schema / properties / totalCountAdded value: +{
+ "description": "Total relevant matches before the limit was applied.",
+ "type": "number"
+}Output schema / properties / totalMatchedRemoved value: -{
- "description": "Total relevant matches before the limit was applied.",
- "type": "number"
-}Output schema / requiredPrevious value: -[
- "results",
- "totalMatched",
- "query",
- "scope"
-]New value: +[
+ "results",
+ "scope",
+ "effectiveQuery",
+ "totalCount"
+]cyanheads_describecyanheads_searchSearch and install 4,000+ security-scanned MCP servers from inside any MCP-aware AI client.
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
Search and get install details on MCP servers, right from your agent -- a unified marketplace index.
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Add one secure layer between your agents and this server.
