nxvet-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NerveX Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# nxvet-mcp
+
+[MCP](https://modelcontextprotocol.io) server for the [NxVET API](https://api.nx.vet).
+Lets Claude, Cursor, and other MCP clients work with NxVET data: consultation labels with
+transcripts and SOAP notes, NxHub conversations and device timelines, webhooks, and API keys.
+
+Two ways to use it, same tools either way:
+
+- **Hosted (recommended)**: `https://mcp.nx.vet/mcp` — Streamable HTTP, no install.
+- **Local (npm)**: `npx nxvet-mcp` — stdio transport, for clients without remote-header support
+  (e.g. Claude Desktop before OAuth lands).
+
+## How it works
+
+- **Hosted transport**: Streamable HTTP at `POST /mcp`, fully stateless (no sessions) — safe behind a load balancer.
+- **Auth**: hosted — each request carries the caller's NxVET API key as `Authorization: Bearer nxvet_sk_...`;
+  local — the key comes from the `NXVET_API_KEY` env var. Either way the key is forwarded unchanged to
+  `https://app.nx.vet`; the MCP server stores nothing.
+- Keys are created at [app.nx.vet/integrations](https://app.nx.vet/integrations) → API Keys.
+
+## Connecting a client
+
+Claude Code:
+
+```bash
+claude mcp add nxvet --transport http https://mcp.nx.vet/mcp \
+  --header "Authorization: Bearer nxvet_sk_YOUR_KEY"
+```
+
+`.mcp.json` / other clients:
+
+```json
+{
+  "mcpServers": {
+    "nxvet": {
+      "type": "http",
+      "url": "https://mcp.nx.vet/mcp",
+      "headers": { "Authorization": "Bearer nxvet_sk_YOUR_KEY" }
+    }
+  }
+}
+```
+
+> claude.ai custom connectors currently require OAuth or unauthenticated URLs; header-based
+> API-key auth works in Claude Code, Cursor, and the MCP Inspector. OAuth support is a future step.
+
+Claude Desktop (`claude_desktop_config.json`) or any stdio-only client — uses the npm package:
+
+```json
+{
+  "mcpServers": {
+    "nxvet": {
+      "command": "npx",
+      "args": ["-y", "nxvet-mcp"],
+      "env": { "NXVET_API_KEY": "nxvet_sk_YOUR_KEY" }
+    }
+  }
+}
+```
+
+OpenAI Codex CLI (`~/.codex/config.toml`) — also via the npm package:
+
+```toml
+[mcp_servers.nxvet]
+command = "npx"
+args = ["-y", "nxvet-mcp"]
+env = { "NXVET_API_KEY" = "nxvet_sk_YOUR_KEY" }
+```
+
+Claude Code can use the local package too (instead of the hosted URL), e.g. for offline dev against staging:
+
+```bash
+claude mcp add nxvet -e NXVET_API_KEY=nxvet_sk_YOUR_KEY -- npx -y nxvet-mcp
+```
+
+## Tools
+
+| Area | Tools |
+|---|---|
+| Identity | `get_identity` |
+| Labels & transcripts | `list_labels`, `get_label`, `assign_patient_to_label`, `aggregate_labels`, `regenerate_label`, `list_medical_templates` |
+| NxHub conversations | `list_conversations`, `get_conversation`, `get_device_timeline`, `preview_conversation`, `create_conversation`, `complete_conversation` |
+| Webhooks | `list_webhooks`, `create_webhook`, `delete_webhook`, `test_webhook`, `enable_webhook`, `get_webhook_deliveries` |
+| API keys | `list_api_keys`, `create_api_key`, `revoke_api_key` |
+
+## Development
+
+```bash
+npm install
+npm run dev        # tsx watch on :3000
+npm run build      # tsc → dist/
+npm start
+```
+
+Environment variables:
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `PORT` | `3000` | HTTP listen port |
+| `NXVET_API_BASE` | `https://app.nx.vet` | Upstream NxVET API (point at staging for testing) |
+
+Smoke test with the MCP Inspector:
+
+```bash
+npx @modelcontextprotocol/inspector
+# Transport: Streamable HTTP, URL: http://localhost:3000/mcp
+# Add header Authorization: Bearer nxvet_sk_...
+```
+
+## Deployment
+
+Container listens on `:3000` with `GET /health` for health checks — ready for App Runner / ECS:
+
+```bash
+docker build -t nxvet-mcp .
+docker run -p 3000:3000 nxvet-mcp
+```
+
+(For ECS from Apple Silicon, remember `docker buildx build --platform linux/amd64`.)

package/dist/client.js

@@ -0,0 +1,81 @@
+/**
+ * Thin HTTP client for the NxVET REST API (https://app.nx.vet).
+ * One instance per MCP request; the caller's API key is forwarded verbatim.
+ */
+export class NxVetApiError extends Error {
+    status;
+    responseBody;
+    constructor(status, responseBody, method, path) {
+        super(`NxVET API ${method} ${path} failed with status ${status}`);
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = "NxVetApiError";
+    }
+}
+export class NxVetApiClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = process.env.NXVET_API_BASE ?? "https://app.nx.vet") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+    }
+    async get(path, query) {
+        return this.request("GET", path, { query });
+    }
+    async post(path, options = {}) {
+        return this.request("POST", path, options);
+    }
+    async delete(path) {
+        return this.request("DELETE", path, {});
+    }
+    async request(method, path, options) {
+        const url = new URL(this.baseUrl + path);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value === undefined)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value)
+                    url.searchParams.append(key, item);
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const response = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                Accept: "application/json",
+                ...(options.body !== undefined ? { "Content-Type": "application/json" } : {}),
+            },
+            body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+        });
+        const text = await response.text();
+        let body = null;
+        if (text.length > 0) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        const allowed = options.allowStatuses ?? [];
+        if (!response.ok && !allowed.includes(response.status)) {
+            throw new NxVetApiError(response.status, body, method, path);
+        }
+        return { status: response.status, headers: response.headers, body };
+    }
+    /**
+     * POST /api/labels/{id}/lambda is fire-and-forget: the API gateway often
+     * times out (504) while the regeneration job keeps running. Both 200 and
+     * 504 mean "triggered" — never retry on 504.
+     */
+    async postLambdaRegenerate(labelId, query) {
+        return this.request("POST", `/api/labels/${labelId}/lambda`, {
+            query,
+            allowStatuses: [504],
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/format.js

@@ -0,0 +1,42 @@
+import { NxVetApiError } from "./client.js";
+/** Cap tool output so a huge transcript list can't blow out the client context. */
+const MAX_RESULT_CHARS = 100_000;
+export function jsonResult(data, note) {
+    let text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    if (text.length > MAX_RESULT_CHARS) {
+        text =
+            text.slice(0, MAX_RESULT_CHARS) +
+                `\n… [truncated at ${MAX_RESULT_CHARS} chars — narrow the query (smaller limit/pageSize or a tighter time range) to see full results]`;
+    }
+    if (note) {
+        text = `${note}\n\n${text}`;
+    }
+    return { content: [{ type: "text", text }] };
+}
+export function errorResult(error) {
+    let text;
+    if (error instanceof NxVetApiError) {
+        const hints = {
+            401: "The API key is invalid, expired, or revoked. Verify it with the get_identity tool.",
+            403: "The key is valid but lacks permission for this organization or operation.",
+            404: "Resource not found — check the ID.",
+            429: "Rate limited — wait and retry with exponential backoff.",
+        };
+        const hint = hints[error.status] ? ` ${hints[error.status]}` : "";
+        text = `${error.message}.${hint}\nResponse body: ${JSON.stringify(error.responseBody)}`;
+    }
+    else {
+        text = `Request failed: ${error instanceof Error ? error.message : String(error)}`;
+    }
+    return { isError: true, content: [{ type: "text", text }] };
+}
+/** Wrap a tool handler so NxVET API errors surface as tool errors, not protocol errors. */
+export async function run(fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,IAAa;IACrD,IAAI,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACnC,IAAI;YACF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC;gBAC/B,qBAAqB,gBAAgB,iGAAiG,CAAC;IAC3I,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,GAAG,GAAG,IAAI,OAAO,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,KAAK,GAA2B;YACpC,GAAG,EAAE,oFAAoF;YACzF,GAAG,EAAE,2EAA2E;YAChF,GAAG,EAAE,oCAAoC;YACzC,GAAG,EAAE,yDAAyD;SAC/D,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;IAC1F,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,EAAiC;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { buildServer, SERVER_NAME, SERVER_VERSION } from "./server.js";
+const PORT = Number(process.env.PORT ?? 3000);
+const app = express();
+app.disable("x-powered-by");
+app.use(express.json({ limit: "1mb" }));
+app.get("/health", (_req, res) => {
+    res.json({ status: "ok", name: SERVER_NAME, version: SERVER_VERSION });
+});
+/**
+ * Stateless Streamable HTTP MCP endpoint.
+ * Every POST carries the full JSON-RPC message plus the caller's NxVET API key
+ * as `Authorization: Bearer nxvet_sk_...`; a fresh server + transport pair is
+ * created per request, so any instance behind a load balancer can serve it.
+ */
+app.post("/mcp", async (req, res) => {
+    const auth = req.headers.authorization;
+    if (!auth || !auth.startsWith("Bearer ")) {
+        res
+            .status(401)
+            .set("WWW-Authenticate", 'Bearer realm="nxvet-mcp"')
+            .json({
+            jsonrpc: "2.0",
+            error: {
+                code: -32001,
+                message: "Missing API key. Send 'Authorization: Bearer nxvet_sk_...' — create a key at https://app.nx.vet/integrations",
+            },
+            id: null,
+        });
+        return;
+    }
+    const apiKey = auth.slice("Bearer ".length).trim();
+    const server = buildServer(apiKey);
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // stateless mode
+    });
+    res.on("close", () => {
+        transport.close();
+        server.close();
+    });
+    try {
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        console.error("MCP request failed:", error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: "Internal server error" },
+                id: null,
+            });
+        }
+    }
+});
+// Stateless server: no SSE resumption stream, no sessions to delete.
+const methodNotAllowed = (_req, res) => {
+    res.status(405).json({
+        jsonrpc: "2.0",
+        error: { code: -32000, message: "Method not allowed. This server is stateless — use POST /mcp." },
+        id: null,
+    });
+};
+app.get("/mcp", methodNotAllowed);
+app.delete("/mcp", methodNotAllowed);
+app.listen(PORT, () => {
+    console.log(`${SERVER_NAME} v${SERVER_VERSION} listening on :${PORT} (POST /mcp)`);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.js

@@ -0,0 +1,30 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { NxVetApiClient } from "./client.js";
+import { registerIdentityTools } from "./tools/identity.js";
+import { registerLabelTools } from "./tools/labels.js";
+import { registerConversationTools } from "./tools/conversations.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+import { registerApiKeyTools } from "./tools/apiKeys.js";
+export const SERVER_NAME = "nxvet-mcp";
+export const SERVER_VERSION = "0.1.0";
+/**
+ * Build a fresh MCP server bound to one caller's API key.
+ * The server is stateless — one instance is created per HTTP request and
+ * every NxVET API call forwards the caller's Bearer key unchanged.
+ */
+export function buildServer(apiKey) {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        instructions: "Tools for the NxVET veterinary platform API (app.nx.vet): consultation labels with transcripts and " +
+            "SOAP notes, NxHub ambient-recording conversations and device timelines, webhook management, and API keys. " +
+            "Start with get_identity to discover the caller's organizationId. " +
+            "All *Ms timestamps are Unix epoch milliseconds; label metadata and SOAP content are JSON strings that need parsing.",
+    });
+    const client = new NxVetApiClient(apiKey);
+    registerIdentityTools(server, client);
+    registerLabelTools(server, client);
+    registerConversationTools(server, client);
+    registerWebhookTools(server, client);
+    registerApiKeyTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,qGAAqG;YACrG,4GAA4G;YAC5G,mEAAmE;YACnE,qHAAqH;KACxH,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/stdio.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Local stdio entry point for the npm package (npx nxvet-mcp).
+ * Same tools as the hosted server at mcp.nx.vet; the API key comes from
+ * the NXVET_API_KEY environment variable instead of an Authorization header.
+ * Nothing may write to stdout except the MCP transport.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { buildServer, SERVER_NAME, SERVER_VERSION } from "./server.js";
+const apiKey = process.env.NXVET_API_KEY;
+if (!apiKey) {
+    console.error("Error: the NXVET_API_KEY environment variable is required.\n" +
+        "Create an API key at https://app.nx.vet/integrations (API Keys tab), then configure:\n" +
+        '  "env": { "NXVET_API_KEY": "nxvet_sk_..." }');
+    process.exit(1);
+}
+const server = buildServer(apiKey);
+await server.connect(new StdioServerTransport());
+console.error(`${SERVER_NAME} v${SERVER_VERSION} running on stdio`);
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AACzC,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CACX,8DAA8D;QAC5D,wFAAwF;QACxF,8CAA8C,CACjD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACjD,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,cAAc,mBAAmB,CAAC,CAAC"}

package/dist/tools/apiKeys.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { jsonResult, run } from "../format.js";
+export function registerApiKeyTools(server, client) {
+    server.registerTool("list_api_keys", {
+        title: "List API keys",
+        description: "List all API keys created by the current user (name, prefix, creation/last-used/expiry, revoked flag). Full key values are never returned.",
+        inputSchema: {},
+    }, async () => run(async () => jsonResult((await client.get("/api/api-keys")).body)));
+    server.registerTool("create_api_key", {
+        title: "Create API key",
+        description: "Create a new NxVET API key. IMPORTANT: the full `key` value in the response is shown ONLY ONCE — the user must store it immediately.",
+        inputSchema: {
+            name: z.string().describe("Human-readable key name, e.g. 'Production Integration'"),
+            organizationId: z.string().uuid().describe("Organization the key is scoped to"),
+            expiresAt: z
+                .string()
+                .datetime()
+                .optional()
+                .describe("Optional ISO 8601 expiry, e.g. 2027-01-01T00:00:00Z"),
+        },
+    }, async (body) => run(async () => jsonResult((await client.post("/api/api-keys", { body })).body, "Save the `key` value now — it cannot be retrieved again.")));
+    server.registerTool("revoke_api_key", {
+        title: "Revoke API key",
+        description: "Revoke an API key immediately and irreversibly. Subsequent requests with that key receive 401. " +
+            "Do not revoke the key currently authenticating this MCP session unless the user explicitly asks.",
+        inputSchema: {
+            apiKeyId: z.string().uuid().describe("API key ID (from list_api_keys), not the key value"),
+        },
+    }, async ({ apiKeyId }) => run(async () => {
+        await client.delete(`/api/api-keys/${apiKeyId}`);
+        return jsonResult({ revoked: true, apiKeyId });
+    }));
+}
+//# sourceMappingURL=apiKeys.js.map

package/dist/tools/apiKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeys.js","sourceRoot":"","sources":["../../src/tools/apiKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAsB;IAC3E,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,4IAA4I;QAC9I,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAClF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,sIAAsI;QACxI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACnF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC/E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,KAAK,IAAI,EAAE,CACb,UAAU,CACR,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EACnD,0DAA0D,CAC3D,CACF,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,iGAAiG;YACjG,kGAAkG;QACpG,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SAC3F;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CACrB,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QACjD,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/dist/tools/conversations.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { jsonResult, run } from "../format.js";
+// Device and conversation IDs are interpolated into URL paths — restrict them
+// to safe characters (defense-in-depth alongside encodeURIComponent below).
+const SAFE_ID = /^[A-Za-z0-9._~-]+$/;
+const deviceIdSchema = z
+    .string()
+    .regex(SAFE_ID, "deviceId may only contain letters, digits, and . _ ~ -")
+    .describe("Device ID (e.g. nxhub-B7FA7D4B1D8D28CF)");
+const conversationIdSchema = z
+    .string()
+    .regex(SAFE_ID, "conversationId may only contain letters, digits, and . _ ~ -")
+    .describe("Conversation ID");
+const enc = encodeURIComponent;
+export function registerConversationTools(server, client) {
+    server.registerTool("list_conversations", {
+        title: "List NxHub conversations",
+        description: "List NxHub conversations for an organization with token-based pagination " +
+            "(pass nextPageToken from the previous response as pageToken; hasMore indicates more pages). " +
+            "Timestamps (startMinuteMs, endMinuteMs, createdAt, …) are Unix epoch milliseconds. " +
+            "An UPLOADED conversation has an nxvetLabelId linking to its label (use get_label for the SOAP note).",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID (discover via get_identity)"),
+            deviceId: deviceIdSchema.optional().describe("Filter by device ID"),
+            status: z
+                .enum(["ACTIVE", "COMPLETED", "PROCESSING", "UPLOADED", "FAILED", "FILTERED"])
+                .optional()
+                .describe("Filter by conversation status"),
+            pageSize: z.number().int().min(1).max(100).default(20),
+            pageToken: z.string().optional().describe("nextPageToken from the previous page"),
+        },
+    }, async (args) => run(async () => jsonResult((await client.get("/api/nxhub/conversations", args)).body)));
+    server.registerTool("get_conversation", {
+        title: "Get NxHub conversation details",
+        description: "Get one NxHub conversation, including transcript text, speech/silence stats, status, and speaker matches when available.",
+        inputSchema: {
+            deviceId: deviceIdSchema,
+            conversationId: conversationIdSchema,
+        },
+    }, async ({ deviceId, conversationId }) => run(async () => jsonResult((await client.get(`/api/nxhub/conversations/${enc(deviceId)}/${enc(conversationId)}`)).body)));
+    server.registerTool("get_device_timeline", {
+        title: "Get device timeline",
+        description: "Minute-by-minute speech-activity timeline for a device, including per-minute transcript text where available. " +
+            "Time range must not exceed 6 hours. startMs/endMs are Unix epoch milliseconds.",
+        inputSchema: {
+            deviceId: deviceIdSchema,
+            startMs: z.number().int().describe("Range start, epoch milliseconds"),
+            endMs: z.number().int().describe("Range end, epoch milliseconds (max 6h after startMs)"),
+        },
+    }, async ({ deviceId, startMs, endMs }) => run(async () => jsonResult((await client.get(`/api/nxhub/conversations/timeline/${enc(deviceId)}`, {
+        startMs,
+        endMs,
+    })).body)));
+    server.registerTool("preview_conversation", {
+        title: "Preview conversation creation",
+        description: "Preview the speech/silence breakdown for a device time range before creating a conversation from it. " +
+            "Time range must not exceed 90 minutes.",
+        inputSchema: {
+            deviceId: deviceIdSchema,
+            startMs: z.number().int().describe("Range start, epoch milliseconds"),
+            endMs: z.number().int().describe("Range end, epoch milliseconds (max 90 min after startMs)"),
+        },
+    }, async (args) => run(async () => jsonResult((await client.get("/api/nxhub/conversations/create/preview", args)).body)));
+    server.registerTool("create_conversation", {
+        title: "Create conversation from time range",
+        description: "Create a new NxHub conversation from a device time range (max 90 minutes). " +
+            "Use preview_conversation first to check the range contains speech. " +
+            "Creation queues transcript processing; the conversation moves through COMPLETED → PROCESSING → UPLOADED.",
+        inputSchema: {
+            deviceId: deviceIdSchema,
+            startMs: z.number().int().describe("Range start, epoch milliseconds"),
+            endMs: z.number().int().describe("Range end, epoch milliseconds (max 90 min after startMs)"),
+        },
+    }, async (args) => run(async () => jsonResult((await client.post("/api/nxhub/conversations/create", { body: args })).body)));
+    server.registerTool("complete_conversation", {
+        title: "Force-complete active conversation",
+        description: "Mark an ACTIVE NxHub conversation as completed, triggering transcript processing immediately " +
+            "instead of waiting for the automatic silence-based completion.",
+        inputSchema: {
+            deviceId: deviceIdSchema,
+            conversationId: conversationIdSchema,
+        },
+    }, async ({ deviceId, conversationId }) => run(async () => jsonResult((await client.post(`/api/nxhub/conversations/${enc(deviceId)}/${enc(conversationId)}/complete`))
+        .body)));
+}
+//# sourceMappingURL=conversations.js.map

package/dist/tools/conversations.js.map

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

package/dist/tools/identity.js

@@ -0,0 +1,10 @@
+import { jsonResult, run } from "../format.js";
+export function registerIdentityTools(server, client) {
+    server.registerTool("get_identity", {
+        title: "Get current identity",
+        description: "Return the caller's identity and organization context (userId, email, organizationId, organizationName, API key metadata). " +
+            "Call this FIRST to discover the organizationId required by most other tools and to verify the API key works.",
+        inputSchema: {},
+    }, async () => run(async () => jsonResult((await client.get("/api/auth/me")).body)));
+}
+//# sourceMappingURL=identity.js.map

package/dist/tools/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/tools/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAsB;IAC7E,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,6HAA6H;YAC7H,8GAA8G;QAChH,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC"}

package/dist/tools/labels.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { jsonResult, run } from "../format.js";
+const LABEL_TYPES = [
+    "CombinedClinicConv",
+    "ClinicConversation",
+    "DictationAudio",
+    "AudioButtonRecording",
+    "NxMIC",
+    "NxHubBatch",
+    "DocumentSoap",
+    "PhoneCallAudio",
+    "ButtonRecording",
+    "Temperature",
+    "AggregateLabel",
+    "ClinicConversationChunk",
+];
+export function registerLabelTools(server, client) {
+    server.registerTool("list_labels", {
+        title: "List labels (consultation records)",
+        description: "List an organization's labels (consultation records) with filtering, sorting, and offset pagination. " +
+            "Common types: ClinicConversation (live recording), NxHubBatch (NxHub button recording), NxMIC (NxHub automatic conversation), DictationAudio, AggregateLabel. " +
+            "NOTE: transcripts and SOAP notes (ownedPatientNotes) are ALWAYS null in this list — use get_label for those. " +
+            "The `metadata` field is a JSON string that must be parsed. fromTime/toTime are Unix epoch milliseconds. " +
+            "The response is prefixed with the total record count (from the X-Total-Count header).",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID (discover via get_identity)"),
+            types: z
+                .array(z.enum(LABEL_TYPES))
+                .min(1)
+                .describe("Record types to retrieve"),
+            limit: z.number().int().min(1).max(100).default(20).describe("Max records to return"),
+            offset: z.number().int().min(0).default(0).describe("Records to skip (pagination)"),
+            sortingProperty: z.enum(["FromTime", "Type", "Patient"]).default("FromTime"),
+            isSortingDescending: z.boolean().default(true),
+            createdBy: z.string().uuid().optional().describe("Filter by creating user ID"),
+            patientSearch: z.string().optional().describe("Filter by patient name substring"),
+        },
+    }, async (args) => run(async () => {
+        const { organizationId, ...query } = args;
+        const res = await client.get(`/api/organizations/${organizationId}/labels`, query);
+        const total = res.headers.get("X-Total-Count");
+        return jsonResult(res.body, total !== null ? `Total matching records: ${total}` : undefined);
+    }));
+    server.registerTool("get_label", {
+        title: "Get label details (transcript + SOAP)",
+        description: "Get full details for one label, including ownedPatientNotes with Transcript and SOAP note content. " +
+            "SOAP note `content` and label `metadata` are JSON strings that must be parsed. " +
+            'A SOAP content of "{}" means AI processing has not completed yet.',
+        inputSchema: {
+            labelId: z.string().uuid().describe("Label (record) ID"),
+        },
+    }, async ({ labelId }) => run(async () => jsonResult((await client.get(`/api/labels/${labelId}`)).body)));
+    server.registerTool("assign_patient_to_label", {
+        title: "Assign patient to label",
+        description: "Assign a patient to an existing label (e.g. move a recording off Default Patient).",
+        inputSchema: {
+            labelId: z.string().uuid().describe("Label (record) ID"),
+            patientId: z.string().uuid().describe("Patient ID to assign"),
+        },
+    }, async ({ labelId, patientId }) => run(async () => {
+        await client.post(`/api/labels/${labelId}/assign`, { body: { patientId } });
+        return jsonResult({ assigned: true, labelId, patientId });
+    }));
+    server.registerTool("aggregate_labels", {
+        title: "Aggregate labels",
+        description: "Combine multiple labels into a single aggregated record, optionally applying a medical template " +
+            "(see list_medical_templates). Returns the new aggregated record.",
+        inputSchema: {
+            labelIds: z.array(z.string().uuid()).min(1).describe("Source label IDs to combine"),
+            patientId: z.string().uuid().describe("Patient the aggregated record belongs to"),
+            medicalTemplateId: z.string().uuid().optional().describe("Medical template to apply"),
+        },
+    }, async ({ labelIds, patientId, medicalTemplateId }) => run(async () => {
+        const res = await client.post("/api/labels/aggregate", {
+            body: {
+                LabelIds: labelIds,
+                PatientId: patientId,
+                ...(medicalTemplateId ? { MedicalTemplateId: medicalTemplateId } : {}),
+            },
+        });
+        return jsonResult(res.body);
+    }));
+    server.registerTool("regenerate_label", {
+        title: "Regenerate label output",
+        description: "Trigger async reprocessing/regeneration of a label's AI output (e.g. after changing the medical template). " +
+            "Fire-and-forget: a 504 gateway timeout from the API still means the job was triggered successfully. " +
+            "Poll get_label afterwards to see the refreshed notes.",
+        inputSchema: {
+            labelId: z.string().uuid().describe("Label (record) ID to regenerate"),
+            medicalTemplateIds: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("Medical template IDs to apply"),
+        },
+    }, async ({ labelId, medicalTemplateIds }) => run(async () => {
+        const res = await client.postLambdaRegenerate(labelId, {
+            medicalTemplateIds,
+        });
+        return jsonResult({
+            triggered: true,
+            labelId,
+            httpStatus: res.status,
+            note: res.status === 504
+                ? "504 is expected for this endpoint — regeneration was triggered and runs asynchronously."
+                : "Regeneration triggered.",
+        });
+    }));
+    server.registerTool("list_medical_templates", {
+        title: "List medical templates",
+        description: "List an organization's medical templates (used with aggregate_labels and regenerate_label). " +
+            "Template `content` is a JSON string that must be parsed.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+        },
+    }, async ({ organizationId }) => run(async () => jsonResult((await client.get(`/api/organizations/${organizationId}/medical-templates`)).body)));
+}
+//# sourceMappingURL=labels.js.map

package/dist/tools/labels.js.map

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

package/dist/tools/webhooks.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { jsonResult, run } from "../format.js";
+export function registerWebhookTools(server, client) {
+    server.registerTool("list_webhooks", {
+        title: "List webhooks",
+        description: "List an organization's registered webhooks. Secrets are never returned.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+        },
+    }, async ({ organizationId }) => run(async () => jsonResult((await client.get(`/api/organizations/${organizationId}/webhooks`)).body)));
+    server.registerTool("create_webhook", {
+        title: "Create webhook",
+        description: "Register a webhook endpoint (HTTPS only, max 10 per organization). " +
+            "IMPORTANT: the HMAC signing `secret` in the response is shown ONLY ONCE — the user must store it immediately.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+            url: z.string().url().describe("HTTPS endpoint to deliver events to"),
+            description: z.string().optional().describe("Human-readable description"),
+            eventTypes: z
+                .array(z.string())
+                .min(1)
+                .describe('Event types to subscribe to, e.g. ["conversation_created", "conversation_completed"]'),
+        },
+    }, async ({ organizationId, ...body }) => run(async () => jsonResult((await client.post(`/api/organizations/${organizationId}/webhooks`, { body })).body, "Save the `secret` now — it is shown only once and is required for HMAC signature verification.")));
+    server.registerTool("delete_webhook", {
+        title: "Delete webhook",
+        description: "Delete a webhook and all its delivery logs. Irreversible.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+            webhookId: z.string().uuid().describe("Webhook ID"),
+        },
+    }, async ({ organizationId, webhookId }) => run(async () => {
+        await client.delete(`/api/organizations/${organizationId}/webhooks/${webhookId}`);
+        return jsonResult({ deleted: true, webhookId });
+    }));
+    server.registerTool("test_webhook", {
+        title: "Send webhook test ping",
+        description: "Send a test `ping` event to a webhook endpoint to verify connectivity.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+            webhookId: z.string().uuid().describe("Webhook ID"),
+        },
+    }, async ({ organizationId, webhookId }) => run(async () => {
+        const res = await client.post(`/api/organizations/${organizationId}/webhooks/${webhookId}/test`);
+        return jsonResult(res.body ?? { pingSent: true, webhookId });
+    }));
+    server.registerTool("enable_webhook", {
+        title: "Re-enable webhook",
+        description: "Re-enable a webhook that was auto-disabled after consecutive delivery failures. Resets the failure counter.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+            webhookId: z.string().uuid().describe("Webhook ID"),
+        },
+    }, async ({ organizationId, webhookId }) => run(async () => {
+        const res = await client.post(`/api/organizations/${organizationId}/webhooks/${webhookId}/enable`);
+        return jsonResult(res.body ?? { enabled: true, webhookId });
+    }));
+    server.registerTool("get_webhook_deliveries", {
+        title: "View webhook delivery logs",
+        description: "View the last 50 delivery attempts for a webhook: status codes, response times, and error messages. " +
+            "Useful for debugging why a webhook endpoint is not receiving events.",
+        inputSchema: {
+            organizationId: z.string().uuid().describe("Organization UUID"),
+            webhookId: z.string().uuid().describe("Webhook ID"),
+        },
+    }, async ({ organizationId, webhookId }) => run(async () => jsonResult((await client.get(`/api/organizations/${organizationId}/webhooks/${webhookId}/deliveries`))
+        .body)));
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "nxvet-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the NxVET API (labels, transcripts, NxHub conversations, webhooks, API keys) — hosted at https://mcp.nx.vet/mcp or run locally via npx",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "nxvet-mcp": "dist/stdio.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nervextech/nxvet-mcp.git"
+  },
+  "homepage": "https://api.nx.vet/mcp.html",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "nxvet",
+    "veterinary"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "express": "^4.21.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.15.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.3"
+  }
+}