@cyanheads/cyanheads-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,143 @@
+# cyanheads-mcp-server
+
+**One MCP endpoint. 40+ hosted servers. Semantic search over every tool.**
+
+```
+https://cyanheads.caseyjhand.com/mcp
+```
+
+Add that URL to your MCP client. Your agent gets two tools — `cyanheads_search` and `cyanheads_describe` — and uses them to discover and install any server in the cyanheads fleet without you maintaining a sprawling local config.
+
+---
+
+## Add it to your client
+
+### Claude Desktop
+
+Open `~/Library/Application Support/Claude/claude_desktop_config.json` and merge into `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "cyanheads": {
+      "type": "sse",
+      "url": "https://cyanheads.caseyjhand.com/mcp"
+    }
+  }
+}
+```
+
+### Claude Code
+
+```sh
+claude mcp add --transport sse cyanheads https://cyanheads.caseyjhand.com/mcp
+```
+
+### Cursor
+
+Merge into `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "cyanheads": {
+      "type": "sse",
+      "url": "https://cyanheads.caseyjhand.com/mcp"
+    }
+  }
+}
+```
+
+### Cline
+
+Merge into Cline's MCP settings:
+
+```json
+{
+  "cyanheads": {
+    "type": "sse",
+    "url": "https://cyanheads.caseyjhand.com/mcp",
+    "disabled": false,
+    "autoApprove": []
+  }
+}
+```
+
+---
+
+## What you can ask
+
+| You say | Agent finds |
+|:--|:--|
+| "search recent arxiv papers about quantum computing" | `arxiv_search` (arxiv-mcp-server), via semantic match on "research papers" |
+| "look up earthquake activity in California" | `earthquake_search` (earthquake-mcp-server) |
+| "what server handles federal spending data?" | `usaspending-mcp-server` (scope: servers) |
+| "find a tool that resolves a place name to coordinates" | `openstreetmap_geocode` (openstreetmap-mcp-server) |
+| "how do I add the bioRxiv server to Cursor?" | Install snippet via `cyanheads_describe` |
+
+After each search match, the agent can ask `cyanheads_describe` to get the connection URL and per-client install snippet so you can add the underlying server directly if you want it always-on.
+
+---
+
+## What's in the fleet
+
+40+ MCP servers spanning four domains. The catalog is regenerated on every portfolio deploy by walking each server's live endpoint — descriptions and tool names always match what the server actually exposes.
+
+| Category | Examples |
+|:--|:--|
+| **Research** | arXiv, bioRxiv, ORCID, Crossref, Wikipedia, Wikidata, OpenLibrary |
+| **Government** | OpenStates, USAspending, CourtListener, NIST NVD, Library of Congress |
+| **Public Data** | Earthquake (USGS), NOAA Weather, GBIF Biodiversity, World Bank, WHO, Eurostat |
+| **Utility** | OpenStreetMap geocoding, Reference Data (constants, timezones, units), WSDOT |
+
+Each server is open source and individually addressable — `cyanheads_describe` returns the direct connection URL alongside the install snippet.
+
+---
+
+## How it works
+
+Two tools, semantic ranking, hosted catalog.
+
+- **`cyanheads_search`** embeds your natural-language query with [Snowflake Arctic Embed M v1.5](https://huggingface.co/Snowflake/snowflake-arctic-embed-m-v1.5) (Matryoshka-truncated to 256 dimensions) and computes cosine similarity against the catalog's pre-computed document vectors. Returns the top-N matching tools or servers.
+- **`cyanheads_describe`** returns the description, connection URL, and per-client install snippet for any tool or server name.
+
+The catalog itself lives at [`caseyjhand.com/fleet.json`](https://caseyjhand.com/fleet.json) — a single JSON file with baked embeddings, regenerated when servers are added or updated. This server polls it hourly and serves search out of an in-memory vector index.
+
+---
+
+## Self-hosting
+
+You probably don't need this — the hosted endpoint is the product. The source is open for reference and the rare case where you want to front your own fleet.
+
+```sh
+git clone https://github.com/cyanheads/cyanheads-mcp-server.git
+cd cyanheads-mcp-server
+bun install
+bun run build
+bun run start:http
+```
+
+Environment variables (all optional):
+
+| Variable | Default | Description |
+|:--|:--|:--|
+| `CATALOG_URL` | `https://caseyjhand.com/fleet.json` | Remote fleet.json endpoint (must be schema v2 with baked embeddings). |
+| `CATALOG_REFRESH_SECONDS` | `3600` | Background poll interval. 0 disables. |
+| `EMBEDDING_MODEL_ID` | `Snowflake/snowflake-arctic-embed-m-v1.5` | Must match `fleet.json.embeddingModel`. |
+| `SIMILARITY_FLOOR` | `0.3` | Cosine similarity threshold below which results are dropped. |
+| `MCP_TRANSPORT_TYPE` | `stdio` | `stdio` or `http`. |
+| `MCP_HTTP_PORT` | `3000` | HTTP port when transport is `http`. |
+
+To point at a different catalog, change `CATALOG_URL` to your own hosted JSON file. See [the cyanheads-mcp-server design doc](./docs/design.md) for the producer-side script and schema.
+
+---
+
+## Built with
+
+- [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) — TypeScript MCP server framework
+- [`@huggingface/transformers`](https://www.npmjs.com/package/@huggingface/transformers) — ONNX-based runtime for embeddings inference
+- [Snowflake Arctic Embed M v1.5](https://huggingface.co/Snowflake/snowflake-arctic-embed-m-v1.5) — embedding model (Apache 2.0)
+
+## License
+
+Apache 2.0. See [LICENSE](./LICENSE).

package/changelog/0.1.x/0.1.0.md

@@ -0,0 +1,12 @@
+---
+summary: "Initial scaffold bootstrap from @cyanheads/mcp-ts-core init"
+breaking: false
+security: false
+---
+
+# 0.1.0 — 2026-05-28
+
+## Added
+
+- Initial scaffold generated by `bunx @cyanheads/mcp-ts-core init`.
+- Project structure, framework wiring, devcheck configuration, baseline project skills.

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,38 @@
+---
+summary: "First public release — cyanheads_search semantic discovery over the cyanheads MCP fleet, cyanheads_describe with per-client install snippets"
+breaking: false
+security: false
+---
+
+# 0.1.1 — 2026-05-28
+
+First substantive release. The scaffold tag (`v0.1.0`) carried no functionality; this release lands the full fleet discovery surface.
+
+## Added
+
+- **`cyanheads_search`** — semantic search over fleet tools and servers. Embeds the query at runtime with [`Snowflake/snowflake-arctic-embed-m-v1.5`](https://huggingface.co/Snowflake/snowflake-arctic-embed-m-v1.5), dot-products against L2-normalized 256-dim Matryoshka-truncated document vectors, filters by category and similarity floor, returns ranked matches. Auth scope: `tool:cyanheads_search:read`.
+- **`cyanheads_describe`** — returns description, hosted connection URL, and per-client install snippets (Claude Desktop, Claude Code, Cursor, Cline) for any named tool or server. Auto-detects kind from name format (underscores → tool, hyphens → server). Auth scope: `tool:cyanheads_describe:read`.
+- **`CatalogService`** — in-memory packed `Float32Array` vector index, atomic-swap refresh on every `fleet.json` `generatedAt` change. Polls hourly by default.
+- **`TransformersEmbeddingsRuntime`** — wraps `@huggingface/transformers`'s `feature-extraction` pipeline. Loads the model once at startup and reuses it for every query.
+- **`RemoteJsonCatalogProvider`** — fetches and Zod-validates the v2 `fleet.json` payload from `CATALOG_URL` (default `https://caseyjhand.com/fleet.json`). Refuses to load on `embeddingModel` mismatch.
+- **Env vars:** `CATALOG_URL`, `CATALOG_FETCH_TIMEOUT_MS`, `CATALOG_REFRESH_SECONDS`, `EMBEDDING_MODEL_ID`, `SIMILARITY_FLOOR`.
+- **Marketing-style README** positioning the hosted endpoint (`https://cyanheads.caseyjhand.com/mcp`) as the product, with per-client install blocks and a category table for the fleet.
+
+## Changed
+
+- **npm name** scoped to `@cyanheads/cyanheads-mcp-server`.
+- **`mcpName`** added (`io.github.cyanheads/cyanheads-mcp-server`) for MCP Registry resolution.
+- **`server.json`** declares all server-specific env vars on both stdio and HTTP package entries.
+
+## Removed
+
+- **Echo scaffold** — five definition files and three tests carried over from `bunx init` removed once real definitions landed.
+- **`manifest.json` / `.mcpbignore` / `.codex-plugin/` / `.claude-plugin/`** — the `.mcpb` bundle and plugin marketplace metadata assumed an npx-stdio install path that conflicts with the hosted-endpoint positioning. The corresponding `bundle` and `lint:packaging` scripts went with them.
+
+Dependencies:
+
+- `@cyanheads/mcp-ts-core` `^0.9.11`
+- `@huggingface/transformers` `4.2.0`
+- `zod` `^4.4.3`
+
+46 tests pass; `bun run devcheck` clean.

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Server-specific configuration schema and lazy accessor.
+ * Separate from the framework's core config — never merge these two schemas.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    catalogUrl: z.ZodDefault<z.ZodString>;
+    catalogFetchTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    catalogRefreshSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    embeddingModelId: z.ZodDefault<z.ZodString>;
+    similarityFloor: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+/** Reset cached config (test-only). */
+export declare function resetServerConfig(): void;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;;iBAgDtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/config/server-config.js

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Server-specific configuration schema and lazy accessor.
+ * Separate from the framework's core config — never merge these two schemas.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    /**
+     * Remote catalog JSON endpoint. Must return a JSON body matching the FleetPayload (v2) schema.
+     * Loaded at server startup via RemoteJsonCatalogProvider.
+     */
+    catalogUrl: z
+        .string()
+        .default('https://caseyjhand.com/fleet.json')
+        .describe('URL of the remote fleet.json catalog endpoint.'),
+    /**
+     * Timeout in milliseconds for the remote catalog fetch.
+     */
+    catalogFetchTimeoutMs: z.coerce
+        .number()
+        .default(10000)
+        .describe('HTTP timeout for remote catalog fetch in milliseconds.'),
+    /**
+     * Background poll interval. The service re-fetches fleet.json on this cadence
+     * and swaps in the new vector index if `generatedAt` changed.
+     * Set to 0 to disable background refresh.
+     */
+    catalogRefreshSeconds: z.coerce
+        .number()
+        .default(3600)
+        .describe('Seconds between background catalog re-fetches. 0 disables background refresh.'),
+    /**
+     * Embedding model identifier. Must match `embeddingModel` declared in fleet.json,
+     * or the server refuses to load (since vectors live in the same space as the
+     * model that produced them).
+     */
+    embeddingModelId: z
+        .string()
+        .default('Snowflake/snowflake-arctic-embed-m-v1.5')
+        .describe('Hugging Face model id used for query embedding at search time. Must match fleet.json.embeddingModel.'),
+    /**
+     * Minimum cosine similarity for a result to surface in cyanheads_search output.
+     * Tunable post-launch based on observed query patterns.
+     */
+    similarityFloor: z.coerce
+        .number()
+        .default(0.3)
+        .describe('Minimum cosine similarity in [0, 1] for a match to appear in search results.'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        catalogUrl: 'CATALOG_URL',
+        catalogFetchTimeoutMs: 'CATALOG_FETCH_TIMEOUT_MS',
+        catalogRefreshSeconds: 'CATALOG_REFRESH_SECONDS',
+        embeddingModelId: 'EMBEDDING_MODEL_ID',
+        similarityFloor: 'SIMILARITY_FLOOR',
+    });
+    return _config;
+}
+/** Reset cached config (test-only). */
+export function resetServerConfig() {
+    _config = undefined;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC;;;OAGG;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,OAAO,CAAC,mCAAmC,CAAC;SAC5C,QAAQ,CAAC,gDAAgD,CAAC;IAE7D;;OAEG;IACH,qBAAqB,EAAE,CAAC,CAAC,MAAM;SAC5B,MAAM,EAAE;SACR,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,wDAAwD,CAAC;IAErE;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,CAAC,MAAM;SAC5B,MAAM,EAAE;SACR,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,+EAA+E,CAAC;IAE5F;;;;OAIG;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,OAAO,CAAC,yCAAyC,CAAC;SAClD,QAAQ,CACP,sGAAsG,CACvG;IAEH;;;OAGG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM;SACtB,MAAM,EAAE;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,UAAU,EAAE,aAAa;QACzB,qBAAqB,EAAE,0BAA0B;QACjD,qBAAqB,EAAE,yBAAyB;QAChD,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,kBAAkB;KACpC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview cyanheads-mcp-server entry point — fleet discovery and passthrough gateway.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview cyanheads-mcp-server entry point — fleet discovery and passthrough gateway.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { describeTool } from './mcp-server/tools/definitions/describe.tool.js';
+import { searchTool } from './mcp-server/tools/definitions/search.tool.js';
+import { getCatalogService, initCatalogService } from './services/catalog/catalog-service.js';
+await createApp({
+    name: 'cyanheads-mcp-server',
+    tools: [searchTool, describeTool],
+    resources: [],
+    prompts: [],
+    instructions: 'This server is the discovery front door to the cyanheads MCP fleet. ' +
+        'Use cyanheads_search to find tools or servers by describing what you want to do. ' +
+        'Use cyanheads_describe to get full schemas and per-client install snippets for any result. ' +
+        'Scope "tools" (default) finds individual tools; scope "servers" finds which server owns a workflow.',
+    async setup() {
+        const config = getServerConfig();
+        initCatalogService(config);
+        await getCatalogService().initialize();
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE9F,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,sBAAsB;IAC5B,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;IACjC,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EACV,sEAAsE;QACtE,mFAAmF;QACnF,6FAA6F;QAC7F,qGAAqG;IAEvG,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,iBAAiB,EAAE,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/describe.tool.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview cyanheads_describe — return connection URL and per-client install snippets
+ * for a named tool or server.
+ * Uses z.discriminatedUnion on 'kind' so the linter walks each branch independently
+ * and format() can dispatch cleanly.
+ * @module mcp-server/tools/definitions/describe
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const describeTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodOptional<z.ZodEnum<{
+        server: "server";
+        tool: "tool";
+    }>>;
+    client: z.ZodOptional<z.ZodEnum<{
+        "claude-desktop": "claude-desktop";
+        "claude-code": "claude-code";
+        cursor: "cursor";
+        cline: "cline";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    result: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"tool">;
+        name: z.ZodString;
+        description: z.ZodString;
+        server: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"server">;
+        name: z.ZodString;
+        displayName: z.ZodString;
+        description: z.ZodString;
+        version: z.ZodString;
+        npm: z.ZodString;
+        github: z.ZodString;
+        endpoint: z.ZodString;
+        auth: z.ZodString;
+        toolCount: z.ZodNumber;
+        installSnippets: z.ZodArray<z.ZodObject<{
+            client: z.ZodEnum<{
+                "claude-desktop": "claude-desktop";
+                "claude-code": "claude-code";
+                cursor: "cursor";
+                cline: "cline";
+            }>;
+            label: z.ZodString;
+            payload: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No tool or server with the given name exists in the catalog.";
+    readonly recovery: "Use cyanheads_search to find the correct name, then call cyanheads_describe again.";
+}, {
+    readonly reason: "ambiguous_kind";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Name matches both a tool and a server (collision in catalog).";
+    readonly recovery: "Set the kind parameter to \"tool\" or \"server\" to disambiguate.";
+}, {
+    readonly reason: "catalog_empty";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "Catalog has not finished loading.";
+    readonly recovery: "Retry in a few seconds; the catalog is still loading.";
+    readonly retryable: true;
+}]>;
+//# sourceMappingURL=describe.tool.d.ts.map

package/dist/mcp-server/tools/definitions/describe.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/describe.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAIjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8MvB,CAAC"}