@aveq-research/surfmeter-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AVEQ GmbH
+
+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,127 @@
+# Surfmeter MCP Server
+
+A Model Context Protocol server for the AVEQ Surfmeter management API. It exposes typed tools for clients, measurements, anomalies, groups, ISPs, users, keys, capabilities, settings, license usage, and the built-in AI assistant.
+
+## Requirements
+
+- Node.js 20 or newer
+- A Surfmeter management API key beginning with `client_admin-`
+- A reachable Surfmeter server
+
+## Installation
+
+Install the MCP server globally:
+
+```bash
+pnpm add --global @aveq-research/surfmeter-mcp
+```
+
+## Configuration
+
+The server requires two environment variables:
+
+- `API_ENDPOINT`: Either the Surfmeter server origin, such as `https://surfmeter-server.demo-analytics.aveq.info`, or the complete management endpoint, such as `https://surfmeter-server.demo-analytics.aveq.info/client_admin_api/v1`.
+- `API_KEY`: A Surfmeter management API key. It is sent in the `X-API-KEY` request header.
+- `API_TIMEOUT_MS`: Optional request timeout in milliseconds. The default is 30000.
+
+Do not put a real key in source control. `.env` is ignored, but MCP clients should normally inject the values through their server configuration.
+
+## MCP client configuration
+
+Configure your MCP client to launch the installed `surfmeter-mcp` executable:
+
+```json
+{
+  "mcpServers": {
+    "surfmeter": {
+      "command": "surfmeter-mcp",
+      "env": {
+        "API_ENDPOINT": "https://surfmeter-server.demo-analytics.aveq.info",
+        "API_KEY": "client_admin-replace-me"
+      }
+    }
+  }
+}
+```
+
+## Tool surface
+
+The server advertises ten tools. Five common operations are promoted directly:
+
+- `surfmeter_get_clients`: list clients or get one client
+- `surfmeter_update_client`: update client labels, tags, or groups
+- `surfmeter_search_measurements`: query and aggregate measurements
+- `surfmeter_search_anomalies`: query and aggregate anomaly episodes
+- `surfmeter_get_system_status`: read version, measurement options, license usage, or AI status
+
+The complete management API remains available through a searchable internal action catalog:
+
+- `surfmeter_search_actions`: find operations from a natural-language intent
+- `surfmeter_describe_action`: retrieve one operation's exact parameter schema
+- `surfmeter_execute_read_action`: execute discovered read-only operations
+- `surfmeter_execute_write_action`: execute discovered non-destructive mutations
+- `surfmeter_execute_destructive_action`: execute deletes, revocations, merges, and client disabling
+
+For example:
+
+```json
+{
+  "query": "create a registration key",
+  "category": "write"
+}
+```
+
+The result identifies the action, its parameter names, and the correct executor. Use `surfmeter_describe_action` when the exact schema is needed, then pass the selected action to that executor:
+
+```json
+{
+  "action_id": "surfmeter_create_registration_key",
+  "params": {
+    "comment": "Video probes",
+    "capability_id": 12
+  }
+}
+```
+
+The server validates `params` against the selected action's internal Zod schema. It rejects action/executor category mismatches. Read, write, and destructive executors have separate MCP annotations so compatible hosts can apply the correct confirmation behavior.
+
+The internal catalog covers clients, groups, ISP contracts, ISPs, users, API keys, registration keys, capabilities, measurements, anomalies, tuning overrides, settings, license usage, and Surfmeter's built-in AI assistant.
+
+Magic-link and session endpoints are intentionally not exposed. They are browser authentication mechanisms and are neither needed nor appropriate when the MCP server already authenticates with a management API key.
+
+## Elasticsearch searches
+
+`surfmeter_search_measurements` and `surfmeter_search_anomalies` accept Elasticsearch Query DSL under `body`.
+
+Use `.keyword` for exact matching, aggregations, and sorting on text fields:
+
+```json
+{
+  "body": {
+    "size": 0,
+    "query": {
+      "term": {
+        "type.keyword": "VideoMeasurement"
+      }
+    },
+    "aggs": {
+      "by_client": {
+        "terms": {
+          "field": "client_label.keyword"
+        }
+      }
+    }
+  }
+}
+```
+
+The server parses normal JSON and Elasticsearch NDJSON scroll responses. Prefer server-side filtering and aggregation to downloading and filtering large datasets in the agent.
+
+## Agent skill
+
+The companion [Surfmeter skills repository](https://github.com/aveq-research/surfmeter-skills) teaches compatible coding agents how to invoke the API directly, and how to construct Elasticsearch requests.
+Skills are orthogonal to MCP servers. You may choose to not load an MCP server's heavy tool definition in all sessions; skills are a good, lightweight alternative to that.
+
+## Development
+
+See [DEVELOPERS.md](DEVELOPERS.md) for contributor setup, build instructions, implementation notes, and testing.

package/build/client.d.ts

@@ -0,0 +1,25 @@
+import type { SurfmeterConfig } from "./config.js";
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export type QueryValue = string | number | boolean | null | undefined | readonly (string | number | boolean)[];
+export interface ApiRequest {
+    method?: HttpMethod;
+    path: string;
+    query?: Record<string, QueryValue>;
+    body?: unknown;
+}
+export interface ApiResponse {
+    data: unknown;
+    contentType: string;
+    status: number;
+}
+export declare class SurfmeterApiError extends Error {
+    readonly status: number;
+    readonly details: unknown;
+    constructor(status: number, message: string, details: unknown);
+}
+export declare class SurfmeterClient {
+    private readonly config;
+    private readonly fetchImpl;
+    constructor(config: SurfmeterConfig, fetchImpl?: typeof fetch);
+    request(request: ApiRequest): Promise<ApiResponse>;
+}

package/build/client.js

@@ -0,0 +1,102 @@
+export class SurfmeterApiError extends Error {
+    status;
+    details;
+    constructor(status, message, details) {
+        super(`Surfmeter API request failed (${status}): ${message}`);
+        this.name = "SurfmeterApiError";
+        this.status = status;
+        this.details = details;
+    }
+}
+function addQuery(url, query) {
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            for (const entry of value) {
+                url.searchParams.append(key, String(entry));
+            }
+        }
+        else {
+            url.searchParams.set(key, String(value));
+        }
+    }
+}
+function messageFromError(data, fallback) {
+    if (typeof data === "object" && data !== null) {
+        const object = data;
+        for (const key of ["message", "error"]) {
+            if (typeof object[key] === "string" && object[key].length > 0) {
+                return object[key];
+            }
+        }
+    }
+    return fallback;
+}
+function parseNdjson(text) {
+    return text
+        .split(/\r?\n/)
+        .filter((line) => line.trim().length > 0)
+        .map((line) => JSON.parse(line));
+}
+async function parseResponse(response) {
+    if (response.status === 204) {
+        return {};
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    const text = await response.text();
+    if (text.length === 0) {
+        return {};
+    }
+    if (contentType.includes("application/x-ndjson")) {
+        return parseNdjson(text);
+    }
+    if (contentType.includes("json")) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new Error("Surfmeter API returned invalid JSON");
+        }
+    }
+    return text;
+}
+export class SurfmeterClient {
+    config;
+    fetchImpl;
+    constructor(config, fetchImpl = fetch) {
+        this.config = config;
+        this.fetchImpl = fetchImpl;
+    }
+    async request(request) {
+        const url = new URL(`${this.config.apiEndpoint}/${request.path.replace(/^\/+/, "")}`);
+        if (request.query) {
+            addQuery(url, request.query);
+        }
+        const method = request.method ?? "GET";
+        const body = request.body === undefined ? {} : { body: JSON.stringify(request.body) };
+        const response = await this.fetchImpl(url, {
+            method,
+            headers: {
+                Accept: "application/json, application/x-ndjson, text/plain",
+                "X-API-KEY": this.config.apiKey,
+                ...(request.body === undefined
+                    ? {}
+                    : { "Content-Type": "application/json" }),
+            },
+            ...body,
+            signal: AbortSignal.timeout(this.config.timeoutMs),
+        });
+        const data = await parseResponse(response);
+        if (!response.ok) {
+            throw new SurfmeterApiError(response.status, messageFromError(data, response.statusText), data);
+        }
+        return {
+            data,
+            contentType: response.headers.get("content-type") ?? "",
+            status: response.status,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

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

package/build/config.d.ts

@@ -0,0 +1,7 @@
+export interface SurfmeterConfig {
+    apiEndpoint: string;
+    apiKey: string;
+    timeoutMs: number;
+}
+export declare function normalizeApiEndpoint(value: string): string;
+export declare function loadConfig(env?: NodeJS.ProcessEnv): SurfmeterConfig;

package/build/config.js

@@ -0,0 +1,46 @@
+const API_PATH = "/client_admin_api/v1";
+export function normalizeApiEndpoint(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error("API_ENDPOINT must be an absolute HTTP(S) URL");
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("API_ENDPOINT must use http or https");
+    }
+    url.search = "";
+    url.hash = "";
+    url.pathname = url.pathname.replace(/\/+$/, "");
+    if (!url.pathname.endsWith(API_PATH)) {
+        url.pathname = `${url.pathname}${API_PATH}`.replace(/\/+/g, "/");
+    }
+    return url.toString().replace(/\/$/, "");
+}
+function parseTimeout(value) {
+    if (value === undefined) {
+        return 30_000;
+    }
+    const timeout = Number(value);
+    if (!Number.isInteger(timeout) || timeout < 1 || timeout > 300_000) {
+        throw new Error("API_TIMEOUT_MS must be an integer between 1 and 300000");
+    }
+    return timeout;
+}
+export function loadConfig(env = process.env) {
+    const endpoint = env.API_ENDPOINT?.trim();
+    const apiKey = env.API_KEY?.trim();
+    if (!endpoint) {
+        throw new Error("Missing required environment variable API_ENDPOINT");
+    }
+    if (!apiKey) {
+        throw new Error("Missing required environment variable API_KEY");
+    }
+    return {
+        apiEndpoint: normalizeApiEndpoint(endpoint),
+        apiKey,
+        timeoutMs: parseTimeout(env.API_TIMEOUT_MS),
+    };
+}
+//# sourceMappingURL=config.js.map

package/build/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,GAAQ,CAAC;IAEb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEhD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,QAAQ,GAAG,GAAG,GAAG,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO;QACL,WAAW,EAAE,oBAAoB,CAAC,QAAQ,CAAC;QAC3C,MAAM;QACN,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { createServer } from "./server.js";
+async function main() {
+    const config = loadConfig();
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`Surfmeter MCP server connected to ${config.apiEndpoint} over stdio`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Surfmeter MCP server failed: ${message}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CACX,qCAAqC,MAAM,CAAC,WAAW,aAAa,CACrE,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/build/result.d.ts

@@ -0,0 +1,3 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function successResult(data: unknown): CallToolResult;
+export declare function errorResult(error: unknown): CallToolResult;

package/build/result.js

@@ -0,0 +1,27 @@
+import { SurfmeterApiError } from "./client.js";
+export function successResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof data === "string" ? data : JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function errorResult(error) {
+    const message = error instanceof Error ? error.message : "Unknown Surfmeter MCP error";
+    const details = error instanceof SurfmeterApiError ? error.details : undefined;
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: details === undefined
+                    ? message
+                    : `${message}\n${JSON.stringify(details, null, 2)}`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=result.js.map

package/build/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACtE;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;IACzE,MAAM,OAAO,GACX,KAAK,YAAY,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,OAAO,KAAK,SAAS;oBACnB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,GAAG,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACxD;SACF;KACF,CAAC;AACJ,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SurfmeterConfig } from "./config.js";
+export declare function createServer(config: SurfmeterConfig): McpServer;

package/build/server.js

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SurfmeterClient } from "./client.js";
+import { registerSurfmeterTools } from "./tools.js";
+export function createServer(config) {
+    const server = new McpServer({
+        name: "surfmeter",
+        version: "0.2.0",
+    }, {
+        instructions: "Use the promoted client, measurement, anomaly, and system-status tools directly. For every other operation, call surfmeter_search_actions, then use the executor named in its result. Call surfmeter_describe_action when the exact schema is needed. Never pass a write action to the read executor or a destructive action to the normal write executor. Confirm exact targets and consequences before calling surfmeter_execute_destructive_action. Elasticsearch exact text matches, aggregations, and sorts should use .keyword fields.",
+    });
+    registerSurfmeterTools(server, new SurfmeterClient(config));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/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;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EACV,8gBAA8gB;KACjhB,CACF,CAAC;IAEF,sBAAsB,CAAC,MAAM,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SurfmeterClient } from "./client.js";
+export declare function registerSurfmeterTools(server: McpServer, client: SurfmeterClient): void;