mcp-dataverse 0.2.5 → 0.3.1

package/dist/doctor.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Diagnostic CLI command for mcp-dataverse.
+ * Usage: npx mcp-dataverse doctor
+ */
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAyG/C"}

package/dist/doctor.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * Diagnostic CLI command for mcp-dataverse.
+ * Usage: npx mcp-dataverse doctor
+ */
+export async function runDoctor() {
+    const out = (msg) => process.stdout.write(msg + "\n");
+    const ok = (msg) => out(`  ✅ ${msg}`);
+    const fail = (msg) => out(`  ❌ ${msg}`);
+    out("");
+    out("🏥 mcp-dataverse doctor");
+    out("─".repeat(50));
+    out("");
+    let allPassed = true;
+    // 1. Node.js version check
+    out("📋 Environment");
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+    if (major >= 20) {
+        ok(`Node.js ${nodeVersion}`);
+    }
+    else {
+        fail(`Node.js ${nodeVersion} — requires v20+`);
+        allPassed = false;
+    }
+    out("");
+    // 2. Configuration check
+    out("⚙️  Configuration");
+    try {
+        const { loadConfig } = await import("./config/config.loader.js");
+        const config = loadConfig();
+        ok(`Environment URL: ${config.environmentUrl}`);
+        ok(`Timeout: ${config.requestTimeoutMs}ms, Retries: ${config.maxRetries}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fail(`Configuration error: ${msg}`);
+        allPassed = false;
+        // Can't proceed without config
+        out("");
+        out(allPassed ? "✅ All checks passed!" : "❌ Some checks failed.");
+        process.exit(allPassed ? 0 : 1);
+    }
+    out("");
+    // 3. Authentication check
+    out("🔑 Authentication");
+    try {
+        const { loadConfig } = await import("./config/config.loader.js");
+        const config = loadConfig();
+        const { createAuthProvider } = await import("./auth/auth-provider.factory.js");
+        const authProvider = createAuthProvider(config);
+        const token = await authProvider.getToken();
+        if (token) {
+            ok("Token acquired successfully");
+            const parts = token.split(".");
+            if (parts.length === 3) {
+                ok("Valid JWT token format");
+            }
+        }
+        else {
+            fail("No token returned");
+            allPassed = false;
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fail(`Auth failed: ${msg}`);
+        allPassed = false;
+    }
+    out("");
+    // 4. API Connectivity (WhoAmI)
+    out("🌐 Dataverse API");
+    try {
+        const { loadConfig } = await import("./config/config.loader.js");
+        const config = loadConfig();
+        const { createAuthProvider } = await import("./auth/auth-provider.factory.js");
+        const { DataverseAdvancedClient } = await import("./dataverse/dataverse-client-advanced.js");
+        const authProvider = createAuthProvider(config);
+        const client = new DataverseAdvancedClient(authProvider, config.maxRetries, config.requestTimeoutMs);
+        const result = await client.whoAmI();
+        ok(`Organization: ${result.OrganizationName || "N/A"}`);
+        ok(`User ID: ${result.UserId || "N/A"}`);
+        ok(`Business Unit: ${result.BusinessUnitId || "N/A"}`);
+        ok(`Environment: ${result.EnvironmentUrl || config.environmentUrl}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        fail(`API call failed: ${msg}`);
+        allPassed = false;
+    }
+    out("");
+    // Summary
+    out("─".repeat(50));
+    if (allPassed) {
+        out("✅ All checks passed! Your mcp-dataverse setup is healthy.");
+    }
+    else {
+        out("❌ Some checks failed. Review the errors above.");
+    }
+    out("");
+    process.exit(allPassed ? 0 : 1);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}

package/dist/http-server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function startHttpTransport(server: Server, port: number, version: string, toolCount: number): Promise<void>;
+//# sourceMappingURL=http-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Ef"}

package/dist/http-server.js

@@ -0,0 +1,61 @@
+import { createServer } from "http";
+import { randomUUID } from "crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+export async function startHttpTransport(server, port, version, toolCount) {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        enableJsonResponse: true,
+    });
+    await server.connect(transport);
+    const httpServer = createServer(async (req, res) => {
+        // CORS headers for browser-based clients
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url ?? "/", `http://localhost:${port}`);
+        if (url.pathname === "/health" && req.method === "GET") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", version, tools: toolCount }));
+            return;
+        }
+        if (url.pathname === "/mcp") {
+            try {
+                await transport.handleRequest(req, res);
+            }
+            catch {
+                if (!res.headersSent) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: "Internal server error" }));
+                }
+            }
+            return;
+        }
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not found" }));
+    });
+    await new Promise((resolve) => {
+        httpServer.listen(port, () => {
+            process.stderr.write(`MCP Dataverse HTTP server listening on http://localhost:${port}/mcp\n`);
+            resolve();
+        });
+    });
+    // Keep the process alive; clean shutdown on signals
+    const shutdown = async () => {
+        process.stderr.write("Shutting down HTTP server...\n");
+        await transport.close();
+        httpServer.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    // Block until server closes
+    await new Promise((resolve) => {
+        httpServer.on("close", resolve);
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6C,MAAM,MAAM,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,IAAY,EACZ,OAAe,EACf,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;QACtC,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAsB,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,YAAY,CAC7B,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,EAAE;QAClD,yCAAyC;QACzC,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAClD,GAAG,CAAC,SAAS,CACX,8BAA8B,EAC9B,4BAA4B,CAC7B,CAAC;QACF,GAAG,CAAC,SAAS,CACX,8BAA8B,EAC9B,8BAA8B,CAC/B,CAAC;QAEF,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAEhE,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACvD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;oBACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;oBAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CACF,CAAC;IAEF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2DAA2D,IAAI,QAAQ,CACxE,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACvD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,4BAA4B;IAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/resources/resource-provider.d.ts

@@ -0,0 +1,11 @@
+import type { Resource, ResourceTemplate } from "@modelcontextprotocol/sdk/types.js";
+import type { DataverseAdvancedClient } from "../dataverse/dataverse-client-advanced.js";
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function listResources(): Resource[];
+export declare function listResourceTemplates(): ResourceTemplate[];
+export declare function readResource(uri: string, client: DataverseAdvancedClient, serverInstructions: string): Promise<ResourceContent>;
+//# sourceMappingURL=resource-provider.d.ts.map

package/dist/resources/resource-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-provider.d.ts","sourceRoot":"","sources":["../../src/resources/resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AA8EzF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,EAC/B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/resources/resource-provider.js

@@ -0,0 +1,79 @@
+// ── Resource Templates (dynamic URIs with parameters) ────────────────────────
+const RESOURCE_TEMPLATES = [
+    {
+        uriTemplate: "dataverse://tables/{tableName}/schema",
+        name: "Table Schema",
+        description: "Returns the full schema (columns, types, requirements) for a Dataverse table",
+        mimeType: "application/json",
+    },
+    {
+        uriTemplate: "dataverse://tables/{tableName}/relationships",
+        name: "Table Relationships",
+        description: "Returns all 1:N and N:N relationships for a Dataverse table",
+        mimeType: "application/json",
+    },
+];
+// ── Static Resources (fixed URIs) ────────────────────────────────────────────
+const STATIC_RESOURCES = [
+    {
+        uri: "dataverse://tables",
+        name: "Available Tables",
+        description: "Lists all custom tables in the connected Dataverse environment",
+        mimeType: "application/json",
+    },
+    {
+        uri: "dataverse://server/instructions",
+        name: "Server Instructions",
+        description: "Usage guidelines and best practices for interacting with this Dataverse MCP server",
+        mimeType: "text/plain",
+    },
+];
+function parseResourceUri(uri) {
+    const PREFIX = "dataverse://";
+    if (!uri.startsWith(PREFIX)) {
+        throw new Error(`Unknown resource URI: ${uri}`);
+    }
+    const path = uri.slice(PREFIX.length);
+    if (path === "tables") {
+        return { type: "tables" };
+    }
+    if (path === "server/instructions") {
+        return { type: "instructions" };
+    }
+    const schemaMatch = /^tables\/([^/]+)\/schema$/.exec(path);
+    if (schemaMatch) {
+        return { type: "schema", tableName: schemaMatch[1] };
+    }
+    const relMatch = /^tables\/([^/]+)\/relationships$/.exec(path);
+    if (relMatch) {
+        return { type: "relationships", tableName: relMatch[1] };
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+}
+export function listResources() {
+    return STATIC_RESOURCES;
+}
+export function listResourceTemplates() {
+    return RESOURCE_TEMPLATES;
+}
+export async function readResource(uri, client, serverInstructions) {
+    const parsed = parseResourceUri(uri);
+    switch (parsed.type) {
+        case "tables": {
+            const tables = await client.listTables(true);
+            return { uri, mimeType: "application/json", text: JSON.stringify(tables, null, 2) };
+        }
+        case "schema": {
+            const metadata = await client.getTableMetadata(parsed.tableName);
+            return { uri, mimeType: "application/json", text: JSON.stringify(metadata, null, 2) };
+        }
+        case "relationships": {
+            const rels = await client.getRelationships(parsed.tableName);
+            return { uri, mimeType: "application/json", text: JSON.stringify(rels, null, 2) };
+        }
+        case "instructions": {
+            return { uri, mimeType: "text/plain", text: serverInstructions };
+        }
+    }
+}
+//# sourceMappingURL=resource-provider.js.map

package/dist/resources/resource-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-provider.js","sourceRoot":"","sources":["../../src/resources/resource-provider.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { readFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
+import { parseTransportArgs } from "./transport.js";
 import { loadConfig } from "./config/config.loader.js";
 import { createAuthProvider } from "./auth/auth-provider.factory.js";
 import { DataverseAdvancedClient } from "./dataverse/dataverse-client-advanced.js";
+import { createToolRegistry } from "./tools/tool-registry.js";
+import { ProgressReporter } from "./tools/progress.js";
 import { authTools, handleAuthTool } from "./tools/auth.tools.js";
 import { metadataTools, handleMetadataTool } from "./tools/metadata.tools.js";
 import { queryTools, handleQueryTool } from "./tools/query.tools.js";
@@ -30,120 +33,102 @@ import { viewTools, handleViewTool } from "./tools/views.tools.js";
 import { orgTools, handleOrgTool } from "./tools/org.tools.js";
 import { fileTools, handleFileTool } from "./tools/file.tools.js";
 import { teamTools, handleTeamTool } from "./tools/teams.tools.js";
-const ALL_TOOLS = [
-    ...authTools,
-    ...metadataTools,
-    ...queryTools,
-    ...crudTools,
-    ...relationTools,
-    ...actionTools,
-    ...batchTools,
-    ...trackingTools,
-    ...solutionTools,
-    ...impersonateTools,
-    ...customizationTools,
-    ...environmentTools,
-    ...traceTools,
-    ...searchTools,
-    ...auditTools,
-    ...qualityTools,
-    ...annotationTools,
-    ...userTools,
-    ...viewTools,
-    ...orgTools,
-    ...fileTools,
-    ...teamTools,
-];
-// Pre-build routing sets once at startup to avoid per-request allocations
-const AUTH_TOOL_NAMES = new Set(authTools.map((t) => t.name));
-const METADATA_TOOL_NAMES = new Set(metadataTools.map((t) => t.name));
-const QUERY_TOOL_NAMES = new Set(queryTools.map((t) => t.name));
-const CRUD_TOOL_NAMES = new Set(crudTools.map((t) => t.name));
-const RELATION_TOOL_NAMES = new Set(relationTools.map((t) => t.name));
-const ACTION_TOOL_NAMES = new Set(actionTools.map((t) => t.name));
-const BATCH_TOOL_NAMES = new Set(batchTools.map((t) => t.name));
-const TRACKING_TOOL_NAMES = new Set(trackingTools.map((t) => t.name));
-const SOLUTION_TOOL_NAMES = new Set(solutionTools.map((t) => t.name));
-const IMPERSONATE_TOOL_NAMES = new Set(impersonateTools.map((t) => t.name));
-const CUSTOMIZATION_TOOL_NAMES = new Set(customizationTools.map((t) => t.name));
-const ENVIRONMENT_TOOL_NAMES = new Set(environmentTools.map((t) => t.name));
-const TRACE_TOOL_NAMES = new Set(traceTools.map((t) => t.name));
-const SEARCH_TOOL_NAMES = new Set(searchTools.map((t) => t.name));
-const AUDIT_TOOL_NAMES = new Set(auditTools.map((t) => t.name));
-const QUALITY_TOOL_NAMES = new Set(qualityTools.map((t) => t.name));
-const ANNOTATION_TOOL_NAMES = new Set(annotationTools.map((t) => t.name));
-const USER_TOOL_NAMES = new Set(userTools.map((t) => t.name));
-const VIEW_TOOL_NAMES = new Set(viewTools.map((t) => t.name));
-const ORG_TOOL_NAMES = new Set(orgTools.map((t) => t.name));
-const FILE_TOOL_NAMES = new Set(fileTools.map((t) => t.name));
-const TEAM_TOOL_NAMES = new Set(teamTools.map((t) => t.name));
+import { routerTools, handleRouterTool } from "./tools/router.tools.js";
+import { listResources, listResourceTemplates, readResource, } from "./resources/resource-provider.js";
+import { workflowTools, handleWorkflowTool } from "./tools/workflow.tools.js";
+// ── Tool Registry — Map-based O(1) dispatch ──────────────────────────────────
+const registry = createToolRegistry([
+    { tools: authTools, handler: handleAuthTool },
+    { tools: metadataTools, handler: handleMetadataTool },
+    { tools: queryTools, handler: handleQueryTool },
+    { tools: crudTools, handler: handleCrudTool },
+    { tools: relationTools, handler: handleRelationTool },
+    { tools: actionTools, handler: handleActionTool },
+    { tools: batchTools, handler: handleBatchTool },
+    { tools: trackingTools, handler: handleTrackingTool },
+    { tools: solutionTools, handler: handleSolutionTool },
+    { tools: customizationTools, handler: handleCustomizationTool },
+    { tools: environmentTools, handler: handleEnvironmentTool },
+    { tools: traceTools, handler: handleTraceTool },
+    { tools: searchTools, handler: handleSearchTool },
+    { tools: auditTools, handler: handleAuditTool },
+    { tools: qualityTools, handler: handleQualityTool },
+    { tools: annotationTools, handler: handleAnnotationTool },
+    { tools: userTools, handler: handleUserTool },
+    { tools: viewTools, handler: handleViewTool },
+    { tools: orgTools, handler: handleOrgTool },
+    { tools: fileTools, handler: handleFileTool },
+    { tools: teamTools, handler: handleTeamTool },
+    { tools: workflowTools, handler: handleWorkflowTool },
+    { tools: routerTools, handler: handleRouterTool },
+]);
+// Impersonate is registered separately — it has a special dispatch signature
+const IMPERSONATE_NAMES = new Set(impersonateTools.map((t) => t.name));
 // Read version from package.json so server.ts never drifts out of sync
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SERVER_VERSION = JSON.parse(readFileSync(join(__dirname, "../package.json"), "utf-8")).version;
+// ── Global MCP Instructions ──────────────────────────────────────────────────
+const SERVER_INSTRUCTIONS = `You are connected to a Microsoft Dataverse environment via the mcp-dataverse server.
+
+## Recommended Workflow
+1. Start with dataverse_whoami to verify authentication.
+2. Use dataverse_list_tables to discover available tables (custom tables only by default).
+3. Use dataverse_get_table_metadata to inspect column names, types, and required fields before querying or writing.
+4. Query data with dataverse_query (OData) or dataverse_execute_fetchxml (complex joins/aggregations).
+5. Use dataverse_create / dataverse_update / dataverse_delete for record operations.
+
+## Best Practices
+- Always specify $select to minimize payload size — never fetch all columns.
+- Use $top to limit results (default 50, max 5000 per page).
+- Prefer dataverse_query for simple reads; use dataverse_execute_fetchxml for aggregations, multi-table joins, or many-to-many traversal.
+- Use dataverse_get_table_metadata before creating/updating records to confirm correct logical field names.
+- For bulk operations (>5 records), use dataverse_batch_execute to reduce HTTP round-trips.
+- Use dataverse_search for full-text search across multiple tables when you don't know which table contains the data.
+- Check dataverse_get_relationships before building FetchXML joins or using dataverse_associate/dataverse_disassociate.
+
+## Safety
+- dataverse_delete is irreversible — always confirm with the user first.
+- Use optimistic concurrency (etag parameter) on updates to prevent lost changes.
+- Impersonation requires explicit privilege and is denied for System Administrator users.
+
+## Performance
+- Avoid retrieving more than 5000 records unless explicitly needed (use dataverse_retrieve_multiple_with_paging with maxTotal).
+- Use server-side filtering ($filter / FetchXML conditions) instead of client-side filtering.
+- Cache table metadata — it rarely changes during a session.
+`;
 /**
- * Routes a tool call to its handler. Used directly by the request handler
- * and passed as the dispatch function to handleImpersonateTool.
+ * Routes a tool call to its handler via the registry Map.
+ * Used directly by the request handler and passed as the dispatch
+ * function to handleImpersonateTool.
  */
-async function dispatchTool(name, args, client) {
-    if (AUTH_TOOL_NAMES.has(name))
-        return handleAuthTool(name, args, client);
-    if (METADATA_TOOL_NAMES.has(name))
-        return handleMetadataTool(name, args, client);
-    if (QUERY_TOOL_NAMES.has(name))
-        return handleQueryTool(name, args, client);
-    if (CRUD_TOOL_NAMES.has(name))
-        return handleCrudTool(name, args, client);
-    if (RELATION_TOOL_NAMES.has(name))
-        return handleRelationTool(name, args, client);
-    if (ACTION_TOOL_NAMES.has(name))
-        return handleActionTool(name, args, client);
-    if (BATCH_TOOL_NAMES.has(name))
-        return handleBatchTool(name, args, client);
-    if (TRACKING_TOOL_NAMES.has(name))
-        return handleTrackingTool(name, args, client);
-    if (SOLUTION_TOOL_NAMES.has(name))
-        return handleSolutionTool(name, args, client);
-    if (CUSTOMIZATION_TOOL_NAMES.has(name))
-        return handleCustomizationTool(name, args, client);
-    if (ENVIRONMENT_TOOL_NAMES.has(name))
-        return handleEnvironmentTool(name, args, client);
-    if (TRACE_TOOL_NAMES.has(name))
-        return handleTraceTool(name, args, client);
-    if (SEARCH_TOOL_NAMES.has(name))
-        return handleSearchTool(name, args, client);
-    if (AUDIT_TOOL_NAMES.has(name))
-        return handleAuditTool(name, args, client);
-    if (QUALITY_TOOL_NAMES.has(name))
-        return handleQualityTool(name, args, client);
-    if (ANNOTATION_TOOL_NAMES.has(name))
-        return handleAnnotationTool(name, args, client);
-    if (USER_TOOL_NAMES.has(name))
-        return handleUserTool(name, args, client);
-    if (VIEW_TOOL_NAMES.has(name))
-        return handleViewTool(name, args, client);
-    if (ORG_TOOL_NAMES.has(name))
-        return handleOrgTool(name, args, client);
-    if (FILE_TOOL_NAMES.has(name))
-        return handleFileTool(name, args, client);
-    if (TEAM_TOOL_NAMES.has(name))
-        return handleTeamTool(name, args, client);
-    throw new Error(`Unknown tool: ${name}`);
+function dispatchTool(name, args, client, progress) {
+    const handler = registry.getHandler(name);
+    if (!handler)
+        throw new Error(`Unknown tool: ${name}`);
+    return handler(name, args, client, progress);
 }
 async function main() {
     const config = loadConfig();
     const authProvider = createAuthProvider(config);
     const client = new DataverseAdvancedClient(authProvider, config.maxRetries, config.requestTimeoutMs);
-    const server = new Server({ name: "mcp-dataverse", version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    const server = new Server({ name: "mcp-dataverse", version: SERVER_VERSION }, {
+        capabilities: { tools: {}, resources: {} },
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    // Combine registry definitions with impersonate tools
+    const allToolDefs = [...registry.getAllDefinitions(), ...impersonateTools];
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: ALL_TOOLS,
+        tools: allToolDefs,
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
+        const progressToken = request.params._meta?.progressToken;
+        const progress = new ProgressReporter(progressToken != null ? server : undefined, progressToken);
         try {
-            if (IMPERSONATE_TOOL_NAMES.has(name)) {
+            if (IMPERSONATE_NAMES.has(name)) {
                 return handleImpersonateTool(name, args, client, dispatchTool);
             }
-            return await dispatchTool(name, args, client);
+            return await dispatchTool(name, args, client, progress);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -153,26 +138,62 @@ async function main() {
             };
         }
     });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // Do not log to stdout — stdio transport uses stdout for protocol messages
-    process.stderr.write("MCP Dataverse server started\n");
-    // Proactively trigger authentication at startup so the device-code prompt
-    // appears immediately in the VS Code MCP Output panel (View → Output → MCP),
-    // rather than only on the first tool call.
-    authProvider.getToken().then(() => {
-        process.stderr.write("[mcp-dataverse] Authenticated ✓\n");
-    }).catch((err) => {
-        const msg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`[mcp-dataverse] Authentication failed: ${msg}\n`);
+    // ── Resource Handlers ────────────────────────────────────────────────────
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listResources(),
+    }));
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+        resourceTemplates: listResourceTemplates(),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const contents = await readResource(request.params.uri, client, SERVER_INSTRUCTIONS);
+        return { contents: [contents] };
     });
+    const transportArgs = parseTransportArgs();
+    if (transportArgs.transport === "http") {
+        const { startHttpTransport } = await import("./http-server.js");
+        const toolCount = allToolDefs.length;
+        process.stderr.write(`Starting HTTP transport on port ${transportArgs.port}...\n`);
+        // Trigger auth before accepting requests
+        try {
+            await authProvider.getToken();
+            process.stderr.write("[mcp-dataverse] Authenticated ✓\n");
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[mcp-dataverse] Authentication failed: ${msg}\n`);
+        }
+        await startHttpTransport(server, transportArgs.port, SERVER_VERSION, toolCount);
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Do not log to stdout — stdio transport uses stdout for protocol messages
+        process.stderr.write("MCP Dataverse server started\n");
+        // Proactively trigger authentication at startup so the device-code prompt
+        // appears immediately in the VS Code MCP Output panel (View → Output → MCP),
+        // rather than only on the first tool call.
+        authProvider
+            .getToken()
+            .then(() => {
+            process.stderr.write("[mcp-dataverse] Authenticated ✓\n");
+        })
+            .catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[mcp-dataverse] Authentication failed: ${msg}\n`);
+        });
+    }
 }
 async function entry() {
-    if (process.argv[2] === "install") {
+    if (process.argv.includes("install")) {
         const { runInstall } = await import("./install.js");
         await runInstall();
         process.exit(0);
     }
+    if (process.argv.includes("doctor")) {
+        const { runDoctor } = await import("./doctor.js");
+        await runDoctor();
+    }
     await main();
 }
 entry().catch((error) => {