@transcend-io/mcp-server-discovery 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# @transcend-io/mcp-server-discovery
+
+> **Alpha** — this package is under active development and has not yet been published to npm. APIs may change without notice.
+
+Transcend MCP Server for data discovery. Provides tools for scanning, classifying, and extracting entities from data.
+
+Requires **Node.js ≥ 22.12** (see `engines` in `package.json`).
+
+For local runs from this repository, copy [`secret.env.example`](../../../secret.env.example) to **`secret.env`** at the repo root (gitignored) and set your API key (see **Run from the monorepo**).
+
+## Install
+
+When the package is available on npm, install the CLI globally:
+
+```bash
+npm install -g @transcend-io/mcp-server-discovery
+```
+
+Until then, run from a checkout of this repository (see **Run from the monorepo** below).
+
+## Usage
+
+```bash
+# With TRANSCEND_API_KEY in the environment; from the monorepo use secret.env (see Run from the monorepo)
+TRANSCEND_API_KEY=your-api-key transcend-mcp-discovery
+```
+
+The process speaks MCP over **stdio** and is meant to be launched by an MCP client (for example Cursor or Claude Desktop), not used as an interactive shell.
+
+### MCP client configuration
+
+`npx` runs the package’s `transcend-mcp-discovery` binary (see `bin` in `package.json`).
+
+```json
+{
+  "mcpServers": {
+    "transcend-discovery": {
+      "command": "npx",
+      "args": ["-y", "@transcend-io/mcp-server-discovery"],
+      "env": {
+        "TRANSCEND_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+When developing in this repository, reuse the same variable names from root **`secret.env`** in the `env` block, or use your client’s env-file support if it has one.
+
+### Run from the monorepo
+
+1. **Credentials** — From the repository root, copy [`secret.env.example`](../../../secret.env.example) to **`secret.env`** and set `TRANSCEND_API_KEY` (and optional URL overrides).
+
+2. **Build and run** — `node ./dist/cli.mjs` matches the `transcend-mcp-discovery` `bin` (use `node` because `pnpm exec transcend-mcp-discovery` may not resolve this package’s own binary in a pnpm workspace):
+
+```bash
+# from the repository root
+pnpm exec turbo run build --filter="@transcend-io/mcp-server-discovery..."
+set -a && source ./secret.env && set +a
+pnpm -F @transcend-io/mcp-server-discovery exec node ./dist/cli.mjs
+```
+
+**Alternative:** `./scripts/mcp-run.sh ./packages/mcp/mcp-server-discovery/dist/cli.mjs` (sources `secret.env` when present; run after build).
+
+See [CONTRIBUTING.md](../../../CONTRIBUTING.md#mcp-servers) for workspace layout and `pnpm --filter` workflows.
+
+### Environment variables
+
+| Variable                | Required | Default                                    | Description       |
+| ----------------------- | -------- | ------------------------------------------ | ----------------- |
+| `TRANSCEND_API_KEY`     | Yes      | —                                          | Transcend API key |
+| `TRANSCEND_API_URL`     | No       | `https://multi-tenant.sombra.transcend.io` | Sombra API URL    |
+| `TRANSCEND_GRAPHQL_URL` | No       | `https://api.transcend.io`                 | GraphQL API URL   |
+
+**Monorepo:** keep these in root **`secret.env`** (from [`secret.env.example`](../../../secret.env.example)); see **Run from the monorepo**.
+
+## Tools
+
+- `discovery_list_scans` — List data discovery scans
+- `discovery_get_scan` — Get scan details
+- `discovery_start_scan` — Start a new scan
+- `discovery_list_plugins` — List discovery plugins
+- `discovery_classify_text` — Classify text into data categories
+- `discovery_ner_extract` — Extract named entities from text
+
+## Related packages
+
+Also available as part of the unified [`@transcend-io/mcp-server`](../mcp-server/README.md) which includes all domains. See the [root README](../../../README.md#mcp-servers) for the full list.

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { n as getDiscoveryTools, t as DiscoveryMixin } from "./graphql-B5D-riMf.mjs";
+import { TranscendRestClient, createMCPServer } from "@transcend-io/mcp-server-core";
+//#region src/cli.ts
+createMCPServer({
+	name: "transcend-mcp-discovery",
+	version: "1.0.0",
+	getTools: getDiscoveryTools,
+	createClients: (auth, sombraUrl, graphqlUrl) => ({
+		rest: new TranscendRestClient(auth, sombraUrl),
+		graphql: new DiscoveryMixin(auth, graphqlUrl)
+	})
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createMCPServer, TranscendRestClient } from '@transcend-io/mcp-server-core';\n\nimport { DiscoveryMixin } from './graphql.js';\nimport { getDiscoveryTools } from './tools/index.js';\n\ncreateMCPServer({\n  name: 'transcend-mcp-discovery',\n  version: '1.0.0',\n  getTools: getDiscoveryTools,\n  createClients: (auth, sombraUrl, graphqlUrl) => ({\n    rest: new TranscendRestClient(auth, sombraUrl),\n    graphql: new DiscoveryMixin(auth, graphqlUrl),\n  }),\n});\n"],"mappings":";;;;AAMA,gBAAgB;CACd,MAAM;CACN,SAAS;CACT,UAAU;CACV,gBAAgB,MAAM,WAAW,gBAAgB;EAC/C,MAAM,IAAI,oBAAoB,MAAM,UAAU;EAC9C,SAAS,IAAI,eAAe,MAAM,WAAW;EAC9C;CACF,CAAC"}

package/dist/graphql-B5D-riMf.mjs

@@ -0,0 +1,303 @@
+import { PaginationSchema, TranscendGraphQLBase, createListResult, createToolResult, defineTool, z } from "@transcend-io/mcp-server-core";
+//#region src/tools/discovery_classify_text.ts
+const ClassifyTextSchema = z.object({
+	texts: z.array(z.string()).describe("Array of text strings to classify"),
+	categories: z.array(z.string()).optional().describe("Specific categories to classify against (optional)"),
+	model: z.string().optional().describe("LLM model to use for classification (optional)")
+});
+function createDiscoveryClassifyTextTool(clients) {
+	const { rest } = clients;
+	return defineTool({
+		name: "discovery_classify_text",
+		description: "Classify text content using Transcend's LLM classifier to identify data categories",
+		category: "Data Discovery",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: ClassifyTextSchema,
+		handler: async ({ texts, categories, model }) => {
+			return createToolResult(true, {
+				results: await rest.classifyText({
+					texts,
+					categories,
+					model
+				}),
+				inputCount: texts.length,
+				message: `Classified ${texts.length} text(s) successfully`
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/discovery_get_scan.ts
+const GetScanSchema = z.object({ scan_id: z.string().describe("ID of the classification scan to retrieve") });
+function createDiscoveryGetScanTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "discovery_get_scan",
+		description: "Get detailed information about a specific classification scan including results.",
+		category: "Data Discovery",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: GetScanSchema,
+		handler: async ({ scan_id }) => {
+			return createToolResult(true, await graphql.getClassificationScan(scan_id));
+		}
+	});
+}
+//#endregion
+//#region src/tools/discovery_list_plugins.ts
+const ListPluginsSchema = PaginationSchema.extend({ cursor: z.string().optional().describe("Pagination cursor from previous response (where supported)") });
+function createDiscoveryListPluginsTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "discovery_list_plugins",
+		description: "List all available discovery plugins (integration types) in your organization.",
+		category: "Data Discovery",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: ListPluginsSchema,
+		handler: async ({ limit, cursor }) => {
+			const result = await graphql.listDiscoveryPlugins({
+				first: limit,
+				after: cursor
+			});
+			return createListResult(result.nodes, {
+				totalCount: result.totalCount,
+				hasNextPage: result.pageInfo?.hasNextPage
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/discovery_list_scans.ts
+const ListScansSchema = PaginationSchema.extend({ cursor: z.string().optional().describe("Pagination cursor from previous response (where supported)") });
+function createDiscoveryListScansTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "discovery_list_scans",
+		description: "List all data classification scans. Returns data silos with classification info.",
+		category: "Data Discovery",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: ListScansSchema,
+		handler: async ({ limit, cursor }) => {
+			const result = await graphql.listClassificationScans({
+				first: limit,
+				after: cursor
+			});
+			return createListResult(result.nodes, {
+				totalCount: result.totalCount,
+				hasNextPage: result.pageInfo?.hasNextPage
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/discovery_ner_extract.ts
+const NerExtractSchema = z.object({
+	text: z.string().describe("Text to extract entities from"),
+	entity_types: z.array(z.string()).optional().describe("Specific entity types to extract (optional)")
+});
+function createDiscoveryNerExtractTool(clients) {
+	const { rest } = clients;
+	return defineTool({
+		name: "discovery_ner_extract",
+		description: "Extract named entities (PII, organizations, locations, etc.) from text using NER",
+		category: "Data Discovery",
+		readOnly: true,
+		annotations: {
+			readOnlyHint: true,
+			destructiveHint: false,
+			idempotentHint: true
+		},
+		zodSchema: NerExtractSchema,
+		handler: async ({ text, entity_types }) => {
+			const result = await rest.extractEntities({
+				text,
+				entityTypes: entity_types
+			});
+			return createToolResult(true, {
+				entities: result.entities,
+				entityCount: result.entities.length,
+				entityTypes: [...new Set(result.entities.map((e) => e.type))],
+				message: `Extracted ${result.entities.length} entities from text`
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/discovery_start_scan.ts
+const StartScanSchema = z.object({
+	name: z.string().describe("Name for the classification scan"),
+	data_silo_id: z.string().optional().describe("ID of the data silo to scan (optional)"),
+	type: z.string().optional().describe("Type of scan (optional)")
+});
+function createDiscoveryStartScanTool(clients) {
+	const graphql = clients.graphql;
+	return defineTool({
+		name: "discovery_start_scan",
+		description: "Start a new data classification scan on a data silo.",
+		category: "Data Discovery",
+		readOnly: false,
+		confirmationHint: "Starts a new classification scan on the data silo",
+		annotations: {
+			readOnlyHint: false,
+			destructiveHint: false,
+			idempotentHint: false
+		},
+		zodSchema: StartScanSchema,
+		handler: async ({ name, data_silo_id, type }) => {
+			return createToolResult(true, {
+				scan: await graphql.startClassificationScan({
+					name,
+					dataSiloId: data_silo_id,
+					type
+				}),
+				message: `Classification scan "${name}" started successfully`
+			});
+		}
+	});
+}
+//#endregion
+//#region src/tools/index.ts
+function getDiscoveryTools(clients) {
+	return [
+		createDiscoveryClassifyTextTool(clients),
+		createDiscoveryNerExtractTool(clients),
+		createDiscoveryListScansTool(clients),
+		createDiscoveryStartScanTool(clients),
+		createDiscoveryGetScanTool(clients),
+		createDiscoveryListPluginsTool(clients)
+	];
+}
+//#endregion
+//#region src/graphql.ts
+var DiscoveryMixin = class extends TranscendGraphQLBase {
+	async listClassificationScans(options) {
+		const data = await this.makeRequest(`
+      query ListDataSilosForClassification($first: Int) {
+        dataSilos(first: $first) {
+          nodes {
+            id
+            title
+            type
+            createdAt
+          }
+          totalCount
+        }
+      }
+    `, { first: Math.min(options?.first || 50, 100) });
+		const scans = data.dataSilos.nodes.map((silo) => ({
+			id: silo.id,
+			name: `Classification: ${silo.title}`,
+			type: silo.type,
+			status: "COMPLETED",
+			dataSiloId: silo.id,
+			createdAt: silo.createdAt
+		}));
+		return {
+			nodes: scans,
+			pageInfo: {
+				hasNextPage: scans.length < data.dataSilos.totalCount,
+				hasPreviousPage: false
+			},
+			totalCount: data.dataSilos.totalCount
+		};
+	}
+	async startClassificationScan(input) {
+		return (await this.makeRequest(`
+      mutation StartClassificationScan($input: StartClassificationScanInput!) {
+        startClassificationScan(input: $input) {
+          scan {
+            id
+            name
+            type
+            status
+            startedAt
+            createdAt
+          }
+        }
+      }
+    `, { input })).startClassificationScan.scan;
+	}
+	async getClassificationScan(id) {
+		return (await this.makeRequest(`
+      query GetClassificationScan($id: ID!) {
+        classificationScan(id: $id) {
+          id
+          name
+          type
+          status
+          startedAt
+          completedAt
+          dataSiloId
+          results {
+            id
+            path
+            dataCategory {
+              id
+              name
+              category
+            }
+            confidence
+          }
+          createdAt
+        }
+      }
+    `, { id })).classificationScan;
+	}
+	async listDiscoveryPlugins(options) {
+		const data = await this.makeRequest(`
+      query ListDataSiloTypes($first: Int) {
+        dataSilos(first: $first) {
+          nodes {
+            id
+            title
+            type
+            description
+          }
+          totalCount
+        }
+      }
+    `, { first: options?.first || 50 });
+		const typeMap = /* @__PURE__ */ new Map();
+		data.dataSilos.nodes.forEach((silo) => {
+			if (!typeMap.has(silo.type)) typeMap.set(silo.type, {
+				id: silo.type,
+				name: silo.type.replace(/([A-Z])/g, " $1").trim(),
+				type: silo.type,
+				description: `Integration for ${silo.type}`,
+				isEnabled: true
+			});
+		});
+		const plugins = Array.from(typeMap.values());
+		return {
+			nodes: plugins,
+			pageInfo: {
+				hasNextPage: false,
+				hasPreviousPage: false
+			},
+			totalCount: plugins.length
+		};
+	}
+};
+//#endregion
+export { ListScansSchema as a, ClassifyTextSchema as c, NerExtractSchema as i, getDiscoveryTools as n, ListPluginsSchema as o, StartScanSchema as r, GetScanSchema as s, DiscoveryMixin as t };
+
+//# sourceMappingURL=graphql-B5D-riMf.mjs.map

package/dist/graphql-B5D-riMf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-B5D-riMf.mjs","names":[],"sources":["../src/tools/discovery_classify_text.ts","../src/tools/discovery_get_scan.ts","../src/tools/discovery_list_plugins.ts","../src/tools/discovery_list_scans.ts","../src/tools/discovery_ner_extract.ts","../src/tools/discovery_start_scan.ts","../src/tools/index.ts","../src/graphql.ts"],"sourcesContent":["import { createToolResult, defineTool, z, type ToolClients } from '@transcend-io/mcp-server-core';\n\nexport const ClassifyTextSchema = z.object({\n  texts: z.array(z.string()).describe('Array of text strings to classify'),\n  categories: z\n    .array(z.string())\n    .optional()\n    .describe('Specific categories to classify against (optional)'),\n  model: z.string().optional().describe('LLM model to use for classification (optional)'),\n});\nexport type ClassifyTextInput = z.infer<typeof ClassifyTextSchema>;\n\nexport function createDiscoveryClassifyTextTool(clients: ToolClients) {\n  const { rest } = clients;\n  return defineTool({\n    name: 'discovery_classify_text',\n    description:\n      \"Classify text content using Transcend's LLM classifier to identify data categories\",\n    category: 'Data Discovery',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: ClassifyTextSchema,\n    handler: async ({ texts, categories, model }) => {\n      const results = await rest.classifyText({\n        texts,\n        categories,\n        model,\n      });\n\n      return createToolResult(true, {\n        results,\n        inputCount: texts.length,\n        message: `Classified ${texts.length} text(s) successfully`,\n      });\n    },\n  });\n}\n","import { createToolResult, defineTool, z, type ToolClients } from '@transcend-io/mcp-server-core';\n\nimport type { DiscoveryMixin } from '../graphql.js';\n\nexport const GetScanSchema = z.object({\n  scan_id: z.string().describe('ID of the classification scan to retrieve'),\n});\nexport type GetScanInput = z.infer<typeof GetScanSchema>;\n\nexport function createDiscoveryGetScanTool(clients: ToolClients) {\n  const graphql = clients.graphql as DiscoveryMixin;\n  return defineTool({\n    name: 'discovery_get_scan',\n    description: 'Get detailed information about a specific classification scan including results.',\n    category: 'Data Discovery',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: GetScanSchema,\n    handler: async ({ scan_id }) => {\n      const result = await graphql.getClassificationScan(scan_id);\n      return createToolResult(true, result);\n    },\n  });\n}\n","import {\n  createListResult,\n  defineTool,\n  PaginationSchema,\n  z,\n  type ToolClients,\n} from '@transcend-io/mcp-server-core';\n\nimport type { DiscoveryMixin } from '../graphql.js';\n\nexport const ListPluginsSchema = PaginationSchema.extend({\n  cursor: z\n    .string()\n    .optional()\n    .describe('Pagination cursor from previous response (where supported)'),\n});\nexport type ListPluginsInput = z.infer<typeof ListPluginsSchema>;\n\nexport function createDiscoveryListPluginsTool(clients: ToolClients) {\n  const graphql = clients.graphql as DiscoveryMixin;\n  return defineTool({\n    name: 'discovery_list_plugins',\n    description: 'List all available discovery plugins (integration types) in your organization.',\n    category: 'Data Discovery',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: ListPluginsSchema,\n    handler: async ({ limit, cursor }) => {\n      const result = await graphql.listDiscoveryPlugins({\n        first: limit,\n        after: cursor,\n      });\n      return createListResult(result.nodes, {\n        totalCount: result.totalCount,\n        hasNextPage: result.pageInfo?.hasNextPage,\n      });\n    },\n  });\n}\n","import {\n  createListResult,\n  defineTool,\n  PaginationSchema,\n  z,\n  type ToolClients,\n} from '@transcend-io/mcp-server-core';\n\nimport type { DiscoveryMixin } from '../graphql.js';\n\nexport const ListScansSchema = PaginationSchema.extend({\n  cursor: z\n    .string()\n    .optional()\n    .describe('Pagination cursor from previous response (where supported)'),\n});\nexport type ListScansInput = z.infer<typeof ListScansSchema>;\n\nexport function createDiscoveryListScansTool(clients: ToolClients) {\n  const graphql = clients.graphql as DiscoveryMixin;\n  return defineTool({\n    name: 'discovery_list_scans',\n    description: 'List all data classification scans. Returns data silos with classification info.',\n    category: 'Data Discovery',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: ListScansSchema,\n    handler: async ({ limit, cursor }) => {\n      const result = await graphql.listClassificationScans({\n        first: limit,\n        after: cursor,\n      });\n      return createListResult(result.nodes, {\n        totalCount: result.totalCount,\n        hasNextPage: result.pageInfo?.hasNextPage,\n      });\n    },\n  });\n}\n","import { createToolResult, defineTool, z, type ToolClients } from '@transcend-io/mcp-server-core';\n\nexport const NerExtractSchema = z.object({\n  text: z.string().describe('Text to extract entities from'),\n  entity_types: z\n    .array(z.string())\n    .optional()\n    .describe('Specific entity types to extract (optional)'),\n});\nexport type NerExtractInput = z.infer<typeof NerExtractSchema>;\n\nexport function createDiscoveryNerExtractTool(clients: ToolClients) {\n  const { rest } = clients;\n  return defineTool({\n    name: 'discovery_ner_extract',\n    description: 'Extract named entities (PII, organizations, locations, etc.) from text using NER',\n    category: 'Data Discovery',\n    readOnly: true,\n    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },\n    zodSchema: NerExtractSchema,\n    handler: async ({ text, entity_types }) => {\n      const result = await rest.extractEntities({\n        text,\n        entityTypes: entity_types,\n      });\n\n      return createToolResult(true, {\n        entities: result.entities,\n        entityCount: result.entities.length,\n        entityTypes: [...new Set(result.entities.map((e) => e.type))],\n        message: `Extracted ${result.entities.length} entities from text`,\n      });\n    },\n  });\n}\n","import { createToolResult, defineTool, z, type ToolClients } from '@transcend-io/mcp-server-core';\n\nimport type { DiscoveryMixin } from '../graphql.js';\n\nexport const StartScanSchema = z.object({\n  name: z.string().describe('Name for the classification scan'),\n  data_silo_id: z.string().optional().describe('ID of the data silo to scan (optional)'),\n  type: z.string().optional().describe('Type of scan (optional)'),\n});\nexport type StartScanInput = z.infer<typeof StartScanSchema>;\n\nexport function createDiscoveryStartScanTool(clients: ToolClients) {\n  const graphql = clients.graphql as DiscoveryMixin;\n  return defineTool({\n    name: 'discovery_start_scan',\n    description: 'Start a new data classification scan on a data silo.',\n    category: 'Data Discovery',\n    readOnly: false,\n    confirmationHint: 'Starts a new classification scan on the data silo',\n    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },\n    zodSchema: StartScanSchema,\n    handler: async ({ name, data_silo_id, type }) => {\n      const result = await graphql.startClassificationScan({\n        name,\n        dataSiloId: data_silo_id,\n        type,\n      });\n      return createToolResult(true, {\n        scan: result,\n        message: `Classification scan \"${name}\" started successfully`,\n      });\n    },\n  });\n}\n","import type { ToolDefinition, ToolClients } from '@transcend-io/mcp-server-core';\n\nimport { createDiscoveryClassifyTextTool } from './discovery_classify_text.js';\nimport { createDiscoveryGetScanTool } from './discovery_get_scan.js';\nimport { createDiscoveryListPluginsTool } from './discovery_list_plugins.js';\nimport { createDiscoveryListScansTool } from './discovery_list_scans.js';\nimport { createDiscoveryNerExtractTool } from './discovery_ner_extract.js';\nimport { createDiscoveryStartScanTool } from './discovery_start_scan.js';\n\nexport function getDiscoveryTools(clients: ToolClients): ToolDefinition[] {\n  return [\n    createDiscoveryClassifyTextTool(clients),\n    createDiscoveryNerExtractTool(clients),\n    createDiscoveryListScansTool(clients),\n    createDiscoveryStartScanTool(clients),\n    createDiscoveryGetScanTool(clients),\n    createDiscoveryListPluginsTool(clients),\n  ];\n}\n","import {\n  TranscendGraphQLBase,\n  type PaginatedResponse,\n  type ClassificationScan,\n  type DiscoveryPlugin,\n  type ListOptions,\n} from '@transcend-io/mcp-server-core';\n\nexport class DiscoveryMixin extends TranscendGraphQLBase {\n  async listClassificationScans(\n    options?: ListOptions,\n  ): Promise<PaginatedResponse<ClassificationScan>> {\n    const query = `\n      query ListDataSilosForClassification($first: Int) {\n        dataSilos(first: $first) {\n          nodes {\n            id\n            title\n            type\n            createdAt\n          }\n          totalCount\n        }\n      }\n    `;\n    const data = await this.makeRequest<{\n      dataSilos: {\n        nodes: Array<{ id: string; title: string; type: string; createdAt: string }>;\n        totalCount: number;\n      };\n    }>(query, { first: Math.min(options?.first || 50, 100) });\n    const scans: ClassificationScan[] = data.dataSilos.nodes.map((silo) => ({\n      id: silo.id,\n      name: `Classification: ${silo.title}`,\n      type: silo.type,\n      status: 'COMPLETED',\n      dataSiloId: silo.id,\n      createdAt: silo.createdAt,\n    }));\n    return {\n      nodes: scans,\n      pageInfo: { hasNextPage: scans.length < data.dataSilos.totalCount, hasPreviousPage: false },\n      totalCount: data.dataSilos.totalCount,\n    };\n  }\n\n  async startClassificationScan(input: {\n    name: string;\n    dataSiloId?: string;\n    type?: string;\n  }): Promise<ClassificationScan> {\n    const mutation = `\n      mutation StartClassificationScan($input: StartClassificationScanInput!) {\n        startClassificationScan(input: $input) {\n          scan {\n            id\n            name\n            type\n            status\n            startedAt\n            createdAt\n          }\n        }\n      }\n    `;\n    const data = await this.makeRequest<{ startClassificationScan: { scan: ClassificationScan } }>(\n      mutation,\n      { input },\n    );\n    return data.startClassificationScan.scan;\n  }\n\n  async getClassificationScan(id: string): Promise<ClassificationScan> {\n    const query = `\n      query GetClassificationScan($id: ID!) {\n        classificationScan(id: $id) {\n          id\n          name\n          type\n          status\n          startedAt\n          completedAt\n          dataSiloId\n          results {\n            id\n            path\n            dataCategory {\n              id\n              name\n              category\n            }\n            confidence\n          }\n          createdAt\n        }\n      }\n    `;\n    const data = await this.makeRequest<{ classificationScan: ClassificationScan }>(query, { id });\n    return data.classificationScan;\n  }\n\n  async listDiscoveryPlugins(options?: ListOptions): Promise<PaginatedResponse<DiscoveryPlugin>> {\n    const query = `\n      query ListDataSiloTypes($first: Int) {\n        dataSilos(first: $first) {\n          nodes {\n            id\n            title\n            type\n            description\n          }\n          totalCount\n        }\n      }\n    `;\n    const data = await this.makeRequest<{\n      dataSilos: {\n        nodes: Array<{ id: string; title: string; type: string; description: string | null }>;\n        totalCount: number;\n      };\n    }>(query, { first: options?.first || 50 });\n    const typeMap = new Map<string, DiscoveryPlugin>();\n    data.dataSilos.nodes.forEach((silo) => {\n      if (!typeMap.has(silo.type)) {\n        typeMap.set(silo.type, {\n          id: silo.type,\n          name: silo.type.replace(/([A-Z])/g, ' $1').trim(),\n          type: silo.type,\n          description: `Integration for ${silo.type}`,\n          isEnabled: true,\n        });\n      }\n    });\n    const plugins = Array.from(typeMap.values());\n    return {\n      nodes: plugins,\n      pageInfo: { hasNextPage: false, hasPreviousPage: false },\n      totalCount: plugins.length,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,62 @@
+import { ClassificationScan, DiscoveryPlugin, ListOptions, PaginatedResponse, ToolClients, ToolDefinition, TranscendGraphQLBase, z } from "@transcend-io/mcp-server-core";
+
+//#region src/tools/index.d.ts
+declare function getDiscoveryTools(clients: ToolClients): ToolDefinition[];
+//#endregion
+//#region src/graphql.d.ts
+declare class DiscoveryMixin extends TranscendGraphQLBase {
+  listClassificationScans(options?: ListOptions): Promise<PaginatedResponse<ClassificationScan>>;
+  startClassificationScan(input: {
+    name: string;
+    dataSiloId?: string;
+    type?: string;
+  }): Promise<ClassificationScan>;
+  getClassificationScan(id: string): Promise<ClassificationScan>;
+  listDiscoveryPlugins(options?: ListOptions): Promise<PaginatedResponse<DiscoveryPlugin>>;
+}
+//#endregion
+//#region src/tools/discovery_classify_text.d.ts
+declare const ClassifyTextSchema: z.ZodObject<{
+  texts: z.ZodArray<z.ZodString>;
+  categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ClassifyTextInput = z.infer<typeof ClassifyTextSchema>;
+//#endregion
+//#region src/tools/discovery_get_scan.d.ts
+declare const GetScanSchema: z.ZodObject<{
+  scan_id: z.ZodString;
+}, z.core.$strip>;
+type GetScanInput = z.infer<typeof GetScanSchema>;
+//#endregion
+//#region src/tools/discovery_list_plugins.d.ts
+declare const ListPluginsSchema: z.ZodObject<{
+  limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ListPluginsInput = z.infer<typeof ListPluginsSchema>;
+//#endregion
+//#region src/tools/discovery_list_scans.d.ts
+declare const ListScansSchema: z.ZodObject<{
+  limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+  cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ListScansInput = z.infer<typeof ListScansSchema>;
+//#endregion
+//#region src/tools/discovery_ner_extract.d.ts
+declare const NerExtractSchema: z.ZodObject<{
+  text: z.ZodString;
+  entity_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type NerExtractInput = z.infer<typeof NerExtractSchema>;
+//#endregion
+//#region src/tools/discovery_start_scan.d.ts
+declare const StartScanSchema: z.ZodObject<{
+  name: z.ZodString;
+  data_silo_id: z.ZodOptional<z.ZodString>;
+  type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type StartScanInput = z.infer<typeof StartScanSchema>;
+//#endregion
+export { type ClassifyTextInput, ClassifyTextSchema, DiscoveryMixin, type GetScanInput, GetScanSchema, type ListPluginsInput, ListPluginsSchema, type ListScansInput, ListScansSchema, type NerExtractInput, NerExtractSchema, type StartScanInput, StartScanSchema, getDiscoveryTools };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/tools/index.ts","../src/graphql.ts","../src/tools/discovery_classify_text.ts","../src/tools/discovery_get_scan.ts","../src/tools/discovery_list_plugins.ts","../src/tools/discovery_list_scans.ts","../src/tools/discovery_ner_extract.ts","../src/tools/discovery_start_scan.ts"],"mappings":";;;iBASgB,iBAAA,CAAkB,OAAA,EAAS,WAAA,GAAc,cAAA;;;cCD5C,cAAA,SAAuB,oBAAA;EAC5B,uBAAA,CACJ,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,iBAAA,CAAkB,kBAAA;EAmCvB,uBAAA,CAAwB,KAAA;IAC5B,IAAA;IACA,UAAA;IACA,IAAA;EAAA,IACE,OAAA,CAAQ,kBAAA;EAsBN,qBAAA,CAAsB,EAAA,WAAa,OAAA,CAAQ,kBAAA;EA6B3C,oBAAA,CAAqB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,iBAAA,CAAkB,eAAA;AAAA;;;cCnGlE,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;KAQnB,iBAAA,GAAoB,CAAA,CAAE,KAAA,QAAa,kBAAA;;;cCNlC,aAAA,EAAa,CAAA,CAAA,SAAA;;;KAGd,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,aAAA;;;cCG7B,iBAAA,EAAiB,CAAA,CAAA,SAAA;;;;KAMlB,gBAAA,GAAmB,CAAA,CAAE,KAAA,QAAa,iBAAA;;;cCNjC,eAAA,EAAe,CAAA,CAAA,SAAA;;;;KAMhB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,eAAA;;;cCd/B,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;KAOjB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,gBAAA;;;cCLhC,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;KAKhB,cAAA,GAAiB,CAAA,CAAE,KAAA,QAAa,eAAA"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as ListScansSchema, c as ClassifyTextSchema, i as NerExtractSchema, n as getDiscoveryTools, o as ListPluginsSchema, r as StartScanSchema, s as GetScanSchema, t as DiscoveryMixin } from "./graphql-B5D-riMf.mjs";
+export { ClassifyTextSchema, DiscoveryMixin, GetScanSchema, ListPluginsSchema, ListScansSchema, NerExtractSchema, StartScanSchema, getDiscoveryTools };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@transcend-io/mcp-server-discovery",
+  "version": "0.1.0",
+  "description": "Transcend MCP Server — Data Discovery tools.",
+  "homepage": "https://github.com/transcend-io/tools/tree/main/packages/mcp/mcp-server-discovery",
+  "license": "Apache-2.0",
+  "author": "Transcend Inc.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/transcend-io/tools.git",
+    "directory": "packages/mcp/mcp-server-discovery"
+  },
+  "bin": {
+    "transcend-mcp-discovery": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "@transcend-io/source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check:exports": "attw --pack . --ignore-rules cjs-resolves-to-esm",
+    "check:publint": "publint --level warning --strict --pack pnpm"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "catalog:",
+    "@transcend-io/mcp-server-core": "workspace:*",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "catalog:",
+    "@types/node": "catalog:",
+    "publint": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}