@teamnetwork-nz/tailscale-mcp-server 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,126 @@
1
+ # @teamnetwork-nz/tailscale-mcp-server
2
+
3
+ An MCP server for the [Tailscale API](https://tailscale.com/kb/1101/api), giving MCP clients access to tailnet devices, ACLs, DNS settings, subnet routes, and auth keys.
4
+
5
+ Compatible with Claude Desktop, Claude Code, Cursor, Cline, and any MCP-capable client.
6
+
7
+ ## Requirements
8
+
9
+ - Node.js 18+
10
+ - A Tailscale API access token (Tailscale admin console → Settings → Keys), or an OAuth client secret with the required scopes
11
+
12
+ ## Installation
13
+
14
+ ```bash
15
+ npx @teamnetwork-nz/tailscale-mcp-server
16
+ ```
17
+
18
+ Or install globally:
19
+
20
+ ```bash
21
+ npm install -g @teamnetwork-nz/tailscale-mcp-server
22
+ tailscale-mcp-server
23
+ ```
24
+
25
+ ## Configuration
26
+
27
+ Set these environment variables before starting the server:
28
+
29
+ ### Required
30
+
31
+ | Variable | Description |
32
+ |---|---|
33
+ | `TAILSCALE_API_KEY` | Access token from the admin console's Keys page, or an OAuth client's access token |
34
+
35
+ ### Optional
36
+
37
+ | Variable | Default | Description |
38
+ |---|---|---|
39
+ | `TAILSCALE_TAILNET` | `-` | Tailnet to operate on. `-` means "the default tailnet for the API key/OAuth client". Otherwise use the tailnet's full name, e.g. `example.com` |
40
+ | `TAILSCALE_READWRITE` | `false` | Set to `true` to enable write tools (device management, ACL/DNS updates, auth key management) |
41
+ | `TAILSCALE_BASE_URL` | `https://api.tailscale.com/api/v2` | Override the API base URL (rarely needed) |
42
+ | `TAILSCALE_TRANSPORT` | `stdio` | Transport mode: `stdio` (default, local) or `http` (remote agent hosting) |
43
+ | `TAILSCALE_HTTP_PORT` | `3000` | Port to listen on when `TAILSCALE_TRANSPORT=http` |
44
+ | `TAILSCALE_HTTP_HOST` | `0.0.0.0` | Bind address when `TAILSCALE_TRANSPORT=http` |
45
+
46
+ ## Tools
47
+
48
+ ### Read (always available)
49
+
50
+ | Tool | Description |
51
+ |---|---|
52
+ | `list_devices` | List tailnet devices, optionally filtered by name or tag |
53
+ | `get_device` | Full details for a single device |
54
+ | `get_device_routes` | Advertised and enabled subnet routes for a device |
55
+ | `list_auth_keys` | List auth keys / OAuth clients (no secret material) |
56
+ | `get_auth_key` | Metadata for a single auth key |
57
+ | `get_dns_nameservers` | Tailnet global DNS nameservers |
58
+ | `get_dns_preferences` | MagicDNS enabled/disabled |
59
+ | `get_dns_searchpaths` | Tailnet DNS search paths |
60
+ | `get_acl` | Current ACL policy file (HuJSON) |
61
+
62
+ ### Write (requires `TAILSCALE_READWRITE=true`)
63
+
64
+ | Tool | Description |
65
+ |---|---|
66
+ | `authorize_device` | Authorize or deauthorize a device |
67
+ | `delete_device` | Remove a device from the tailnet |
68
+ | `set_device_tags` | Replace a device's ACL tags |
69
+ | `expire_device_key` | Immediately expire a device's node key |
70
+ | `set_device_routes` | Enable/disable a device's advertised subnet routes |
71
+ | `create_auth_key` | Create a new auth key |
72
+ | `delete_auth_key` | Revoke an auth key |
73
+ | `set_dns_nameservers` | Replace the tailnet's DNS nameservers |
74
+ | `set_dns_preferences` | Enable/disable MagicDNS |
75
+ | `set_dns_searchpaths` | Replace the tailnet's DNS search paths |
76
+ | `update_acl` | Replace the full ACL policy file |
77
+
78
+ ## Claude Desktop configuration
79
+
80
+ Add to `claude_desktop_config.json`:
81
+
82
+ ```json
83
+ {
84
+ "mcpServers": {
85
+ "tailscale": {
86
+ "command": "npx",
87
+ "args": ["-y", "@teamnetwork-nz/tailscale-mcp-server"],
88
+ "env": {
89
+ "TAILSCALE_API_KEY": "tskey-api-your-key-here"
90
+ }
91
+ }
92
+ }
93
+ }
94
+ ```
95
+
96
+ ## Claude Code configuration
97
+
98
+ ```bash
99
+ claude mcp add tailscale \
100
+ -e TAILSCALE_API_KEY=tskey-api-your-key-here \
101
+ -- npx -y @teamnetwork-nz/tailscale-mcp-server
102
+ ```
103
+
104
+ ## Running as a remote HTTP server
105
+
106
+ Set `TAILSCALE_TRANSPORT=http` to start an HTTP server instead of reading from stdin. The server exposes a single endpoint at `/mcp` using the [MCP Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) in stateless mode. A health check is available at `GET /health`.
107
+
108
+ ```bash
109
+ TAILSCALE_API_KEY=tskey-api-your-key \
110
+ TAILSCALE_TRANSPORT=http \
111
+ npx @teamnetwork-nz/tailscale-mcp-server
112
+ ```
113
+
114
+ ## Development
115
+
116
+ ```bash
117
+ npm install
118
+ npm run build
119
+ npm start
120
+ ```
121
+
122
+ ## Security notes
123
+
124
+ - The server runs in **read-only mode by default**. Write tools must be explicitly enabled via `TAILSCALE_READWRITE=true`.
125
+ - `delete_device`, `expire_device_key`, and `update_acl` are disruptive and effectively irreversible — review the tool descriptions and confirm with the model/client before granting write access in a production tailnet.
126
+ - `create_auth_key` returns the plaintext key exactly once in the tool response. It cannot be retrieved again — store it immediately.
@@ -0,0 +1,31 @@
1
+ export interface ClientConfig {
2
+ baseUrl: string;
3
+ apiKey: string;
4
+ tailnet: string;
5
+ }
6
+ export declare class TailscaleApiError extends Error {
7
+ readonly statusCode: number;
8
+ constructor(statusCode: number, message: string);
9
+ }
10
+ export declare class TailscaleClient {
11
+ private readonly baseUrl;
12
+ private readonly tailnet;
13
+ private readonly headers;
14
+ constructor(config: ClientConfig);
15
+ get tailnetName(): string;
16
+ private request;
17
+ /** Lightweight connectivity + auth check. Does not throw — returns a result object. */
18
+ ping(): Promise<{
19
+ ok: boolean;
20
+ status: number;
21
+ message: string;
22
+ }>;
23
+ get<T>(path: string): Promise<T>;
24
+ getRaw<T>(path: string, accept: string): Promise<T>;
25
+ post<T>(path: string, body?: unknown): Promise<T>;
26
+ postRaw<T>(path: string, body: string, contentType: string): Promise<T>;
27
+ delete<T>(path: string): Promise<T>;
28
+ private requestRawBody;
29
+ }
30
+ export declare function createClient(): TailscaleClient;
31
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM;CAKlB;AAkBD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,MAAM,EAAE,YAAY;IAUhC,IAAI,WAAW,IAAI,MAAM,CAExB;YAEa,OAAO;IAyCrB,uFAAuF;IACjF,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBvE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAIrB,cAAc;CAuC7B;AAED,wBAAgB,YAAY,IAAI,eAAe,CAQ9C"}
package/dist/client.js ADDED
@@ -0,0 +1,163 @@
1
+ const DEFAULT_BASE_URL = "https://api.tailscale.com/api/v2";
2
+ export class TailscaleApiError extends Error {
3
+ statusCode;
4
+ constructor(statusCode, message) {
5
+ super(message);
6
+ this.statusCode = statusCode;
7
+ this.name = "TailscaleApiError";
8
+ }
9
+ }
10
+ function buildActionMessage(statusCode, detail) {
11
+ if (statusCode === 401) {
12
+ return `Authentication failed. Check that TAILSCALE_API_KEY is a valid, non-expired access token generated from the admin console's Keys page. Detail: ${detail}`;
13
+ }
14
+ if (statusCode === 403) {
15
+ return `Access denied. The API key's user lacks permission for this operation, or an OAuth client is missing the required scope. Detail: ${detail}`;
16
+ }
17
+ if (statusCode === 404) {
18
+ return `Resource not found. Check the device/key ID and TAILSCALE_TAILNET. Detail: ${detail}`;
19
+ }
20
+ if (statusCode === 429) {
21
+ return `Rate limited by the Tailscale API. Slow down and retry. Detail: ${detail}`;
22
+ }
23
+ return `Tailscale API returned HTTP ${statusCode}. Detail: ${detail}`;
24
+ }
25
+ export class TailscaleClient {
26
+ baseUrl;
27
+ tailnet;
28
+ headers;
29
+ constructor(config) {
30
+ this.baseUrl = config.baseUrl.replace(/\/$/, "");
31
+ this.tailnet = config.tailnet;
32
+ this.headers = {
33
+ Authorization: `Basic ${Buffer.from(`${config.apiKey}:`).toString("base64")}`,
34
+ Accept: "application/json",
35
+ "Content-Type": "application/json",
36
+ };
37
+ }
38
+ get tailnetName() {
39
+ return this.tailnet;
40
+ }
41
+ async request(method, path, options = {}) {
42
+ const url = `${this.baseUrl}${path}`;
43
+ let res;
44
+ try {
45
+ res = await fetch(url, {
46
+ method,
47
+ headers: options.accept ? { ...this.headers, Accept: options.accept } : this.headers,
48
+ ...(options.body !== undefined ? { body: JSON.stringify(options.body) } : {}),
49
+ });
50
+ }
51
+ catch (err) {
52
+ const cause = err.cause;
53
+ const detail = cause?.message ?? err.message;
54
+ throw new Error(`Network error reaching Tailscale API: ${detail}`);
55
+ }
56
+ if (!res.ok) {
57
+ let detail = res.statusText;
58
+ try {
59
+ const body = (await res.json());
60
+ if (body.message)
61
+ detail = body.message;
62
+ }
63
+ catch {
64
+ /* non-JSON error body */
65
+ }
66
+ throw new TailscaleApiError(res.status, buildActionMessage(res.status, detail));
67
+ }
68
+ if (res.status === 204)
69
+ return {};
70
+ if (options.accept === "application/hujson" || options.accept === "text/plain") {
71
+ return (await res.text());
72
+ }
73
+ const text = await res.text();
74
+ if (!text)
75
+ return {};
76
+ return JSON.parse(text);
77
+ }
78
+ /** Lightweight connectivity + auth check. Does not throw — returns a result object. */
79
+ async ping() {
80
+ const url = `${this.baseUrl}/tailnet/${encodeURIComponent(this.tailnet)}/devices`;
81
+ try {
82
+ const res = await fetch(url, { headers: this.headers });
83
+ if (res.ok)
84
+ return { ok: true, status: res.status, message: "OK" };
85
+ let message = res.statusText;
86
+ try {
87
+ const body = (await res.json());
88
+ if (body.message)
89
+ message = body.message;
90
+ }
91
+ catch {
92
+ /* non-JSON */
93
+ }
94
+ return { ok: false, status: res.status, message };
95
+ }
96
+ catch (err) {
97
+ const cause = err.cause;
98
+ const detail = cause?.message ?? err.message;
99
+ return { ok: false, status: 0, message: `Network error: ${detail}` };
100
+ }
101
+ }
102
+ get(path) {
103
+ return this.request("GET", path);
104
+ }
105
+ getRaw(path, accept) {
106
+ return this.request("GET", path, { accept });
107
+ }
108
+ post(path, body) {
109
+ return this.request("POST", path, { body: body ?? {} });
110
+ }
111
+ postRaw(path, body, contentType) {
112
+ return this.requestRawBody("POST", path, body, contentType);
113
+ }
114
+ delete(path) {
115
+ return this.request("DELETE", path);
116
+ }
117
+ async requestRawBody(method, path, body, contentType) {
118
+ const url = `${this.baseUrl}${path}`;
119
+ let res;
120
+ try {
121
+ res = await fetch(url, {
122
+ method,
123
+ headers: { ...this.headers, "Content-Type": contentType },
124
+ body,
125
+ });
126
+ }
127
+ catch (err) {
128
+ const cause = err.cause;
129
+ const detail = cause?.message ?? err.message;
130
+ throw new Error(`Network error reaching Tailscale API: ${detail}`);
131
+ }
132
+ if (!res.ok) {
133
+ let detail = res.statusText;
134
+ try {
135
+ const b = (await res.json());
136
+ if (b.message)
137
+ detail = b.message;
138
+ }
139
+ catch {
140
+ /* non-JSON error body */
141
+ }
142
+ throw new TailscaleApiError(res.status, buildActionMessage(res.status, detail));
143
+ }
144
+ const text = await res.text();
145
+ if (!text)
146
+ return {};
147
+ try {
148
+ return JSON.parse(text);
149
+ }
150
+ catch {
151
+ return text;
152
+ }
153
+ }
154
+ }
155
+ export function createClient() {
156
+ const apiKey = process.env["TAILSCALE_API_KEY"];
157
+ const tailnet = process.env["TAILSCALE_TAILNET"] ?? "-";
158
+ const baseUrl = process.env["TAILSCALE_BASE_URL"] ?? DEFAULT_BASE_URL;
159
+ if (!apiKey)
160
+ throw new Error("TAILSCALE_API_KEY environment variable is required.");
161
+ return new TailscaleClient({ baseUrl, apiKey, tailnet });
162
+ }
163
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
package/dist/index.js ADDED
@@ -0,0 +1,154 @@
1
+ #!/usr/bin/env node
2
+ import http from "node:http";
3
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
4
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
5
+ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
6
+ import { createClient } from "./client.js";
7
+ import { registerDeviceTools } from "./tools/devices.js";
8
+ import { registerKeyTools } from "./tools/keys.js";
9
+ import { registerDnsTools } from "./tools/dns.js";
10
+ import { registerAclTools } from "./tools/acl.js";
11
+ import { registerActionTools } from "./tools/actions.js";
12
+ async function readJsonBody(req) {
13
+ return new Promise((resolve, reject) => {
14
+ const chunks = [];
15
+ req.on("data", (chunk) => chunks.push(chunk));
16
+ req.on("end", () => {
17
+ try {
18
+ resolve(JSON.parse(Buffer.concat(chunks).toString()));
19
+ }
20
+ catch {
21
+ resolve(undefined);
22
+ }
23
+ });
24
+ req.on("error", reject);
25
+ });
26
+ }
27
+ async function main() {
28
+ let client;
29
+ try {
30
+ client = createClient();
31
+ }
32
+ catch (err) {
33
+ process.stderr.write(`[tailscale-mcp] Configuration error: ${err.message}\n`);
34
+ process.exit(1);
35
+ }
36
+ const readwrite = process.env["TAILSCALE_READWRITE"] === "true";
37
+ const transportMode = process.env["TAILSCALE_TRANSPORT"] ?? "stdio";
38
+ process.stderr.write(`[tailscale-mcp] Tailnet: ${client.tailnetName}\n`);
39
+ // Startup connectivity check — warn early rather than failing silently on first tool call
40
+ const ping = await client.ping();
41
+ if (ping.ok) {
42
+ process.stderr.write(`[tailscale-mcp] Connected to the Tailscale API.\n`);
43
+ }
44
+ else if (ping.status === 401 || ping.status === 403) {
45
+ process.stderr.write(`[tailscale-mcp] WARNING: Tailscale auth check failed (HTTP ${ping.status}). ` +
46
+ `Verify TAILSCALE_API_KEY is a valid access token generated from the admin console's Keys page.\n`);
47
+ }
48
+ else if (ping.status === 404) {
49
+ process.stderr.write(`[tailscale-mcp] WARNING: Tailnet not found (HTTP 404). Check TAILSCALE_TAILNET — use "-" for your default tailnet.\n`);
50
+ }
51
+ else if (ping.status === 0) {
52
+ process.stderr.write(`[tailscale-mcp] WARNING: Could not reach the Tailscale API — ${ping.message}\n`);
53
+ }
54
+ else {
55
+ process.stderr.write(`[tailscale-mcp] WARNING: Unexpected response from the Tailscale API during startup check (HTTP ${ping.status}): ${ping.message}\n`);
56
+ }
57
+ if (readwrite) {
58
+ process.stderr.write("[tailscale-mcp] Running in read-write mode (write tools enabled)\n");
59
+ }
60
+ else {
61
+ process.stderr.write("[tailscale-mcp] Running in read-only mode (set TAILSCALE_READWRITE=true to enable write tools)\n");
62
+ }
63
+ const server = new McpServer({
64
+ name: "@teamnetwork-nz/tailscale-mcp-server",
65
+ version: "1.0.0",
66
+ }, {
67
+ instructions: `
68
+ Tailscale MCP server — manage a Tailscale tailnet via the Tailscale REST API.
69
+
70
+ ## Mode
71
+ - Write tools (authorize_device, delete_device, set_device_tags, expire_device_key, set_device_routes, create_auth_key, delete_auth_key, set_dns_nameservers, set_dns_preferences, set_dns_searchpaths, update_acl) are only available when TAILSCALE_READWRITE=true. If those tools are absent, the server is read-only — do not attempt write operations.
72
+
73
+ ## Tailnet
74
+ - All operations apply to the tailnet configured via TAILSCALE_TAILNET (default "-", meaning the API key's own default tailnet).
75
+
76
+ ## Devices
77
+ - list_devices returns the full device list; filter client-side with name or tag.
78
+ - Device IDs from list_devices/get_device are what every other device tool expects (not hostnames or IP addresses).
79
+ - Deleting a device or expiring its key are disruptive, hard-to-reverse actions — confirm intent before calling them.
80
+
81
+ ## Tags
82
+ - set_device_tags fully replaces a device's tag list. Tags referenced must already exist under "tagOwners" in the ACL policy (see get_acl / update_acl), or the API will reject the request.
83
+
84
+ ## Routes
85
+ - get_device_routes shows both advertisedRoutes (requested by the device) and enabledRoutes (approved in the tailnet).
86
+ - set_device_routes replaces the full enabled list — pass all routes that should remain enabled, not just the one being added.
87
+
88
+ ## Auth keys
89
+ - create_auth_key returns the plaintext key exactly once in the response — it cannot be retrieved again afterward. Warn the user to store it immediately.
90
+ - Ephemeral keys create devices that are auto-removed when they disconnect; reusable keys can provision multiple devices.
91
+
92
+ ## ACL
93
+ - get_acl returns the policy file as HuJSON (JSON with comments) — preserve formatting/comments where practical when editing.
94
+ - update_acl replaces the entire policy file, not a partial patch. Always get_acl first, edit that content, then submit the full result.
95
+
96
+ ## DNS
97
+ - set_dns_nameservers and set_dns_searchpaths both replace the full list — include existing entries you want to keep alongside any new ones.
98
+ `.trim(),
99
+ });
100
+ registerDeviceTools(server, client);
101
+ registerKeyTools(server, client);
102
+ registerDnsTools(server, client);
103
+ registerAclTools(server, client);
104
+ if (readwrite)
105
+ registerActionTools(server, client);
106
+ if (transportMode === "http") {
107
+ const port = parseInt(process.env["TAILSCALE_HTTP_PORT"] ?? "3000", 10);
108
+ const host = process.env["TAILSCALE_HTTP_HOST"] ?? "0.0.0.0";
109
+ const transport = new StreamableHTTPServerTransport({
110
+ sessionIdGenerator: undefined, // stateless — suitable for remote agent hosting
111
+ });
112
+ await server.connect(transport);
113
+ const httpServer = http.createServer(async (req, res) => {
114
+ const url = req.url ?? "";
115
+ if (url === "/health") {
116
+ res.writeHead(200, { "Content-Type": "application/json" });
117
+ res.end(JSON.stringify({ status: "ok", server: "@teamnetwork-nz/tailscale-mcp-server" }));
118
+ return;
119
+ }
120
+ if (!url.startsWith("/mcp")) {
121
+ res.writeHead(404);
122
+ res.end();
123
+ return;
124
+ }
125
+ try {
126
+ if (req.method === "POST") {
127
+ const body = await readJsonBody(req);
128
+ await transport.handleRequest(req, res, body);
129
+ }
130
+ else {
131
+ await transport.handleRequest(req, res);
132
+ }
133
+ }
134
+ catch (err) {
135
+ if (!res.headersSent) {
136
+ res.writeHead(500, { "Content-Type": "application/json" });
137
+ res.end(JSON.stringify({ error: err.message }));
138
+ }
139
+ }
140
+ });
141
+ httpServer.listen(port, host, () => {
142
+ process.stderr.write(`[tailscale-mcp] HTTP transport listening on ${host}:${port}/mcp\n`);
143
+ });
144
+ }
145
+ else {
146
+ const transport = new StdioServerTransport();
147
+ await server.connect(transport);
148
+ }
149
+ }
150
+ main().catch((err) => {
151
+ process.stderr.write(`[tailscale-mcp] Fatal: ${err.message}\n`);
152
+ process.exit(1);
153
+ });
154
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { TailscaleClient } from "../client.js";
3
+ export declare function registerAclTools(server: McpServer, client: TailscaleClient): void;
4
+ //# sourceMappingURL=acl.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"acl.d.ts","sourceRoot":"","sources":["../../src/tools/acl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAiBjF"}
@@ -0,0 +1,11 @@
1
+ export function registerAclTools(server, client) {
2
+ server.registerTool("get_acl", {
3
+ title: "Get ACL",
4
+ description: "Get the tailnet's current access control policy file, in HuJSON (JSON with comments) format.",
5
+ inputSchema: {},
6
+ }, async () => {
7
+ const acl = await client.getRaw(`/tailnet/${encodeURIComponent(client.tailnetName)}/acl`, "application/hujson");
8
+ return { content: [{ type: "text", text: acl }] };
9
+ });
10
+ }
11
+ //# sourceMappingURL=acl.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"acl.js","sourceRoot":"","sources":["../../src/tools/acl.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,8FAA8F;QAChG,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAC7B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EACxD,oBAAoB,CACrB,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACpD,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { TailscaleClient } from "../client.js";
3
+ export declare function registerActionTools(server: McpServer, client: TailscaleClient): void;
4
+ //# sourceMappingURL=actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/tools/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAkNpF"}
@@ -0,0 +1,147 @@
1
+ import { z } from "zod";
2
+ export function registerActionTools(server, client) {
3
+ server.registerTool("authorize_device", {
4
+ title: "Authorize Device",
5
+ description: "Authorize or deauthorize a device. Required after a device joins the tailnet when the tailnet has device approval enabled.",
6
+ inputSchema: {
7
+ device_id: z.string().describe("Tailscale device ID"),
8
+ authorized: z.boolean().describe("true to authorize, false to revoke authorization"),
9
+ },
10
+ }, async ({ device_id, authorized }) => {
11
+ await client.post(`/device/${encodeURIComponent(device_id)}/authorized`, { authorized });
12
+ return {
13
+ content: [
14
+ { type: "text", text: `Device ${device_id} ${authorized ? "authorized" : "deauthorized"}.` },
15
+ ],
16
+ };
17
+ });
18
+ server.registerTool("delete_device", {
19
+ title: "Delete Device",
20
+ description: "Permanently remove a device from the tailnet. This cannot be undone.",
21
+ inputSchema: {
22
+ device_id: z.string().describe("Tailscale device ID"),
23
+ },
24
+ }, async ({ device_id }) => {
25
+ await client.delete(`/device/${encodeURIComponent(device_id)}`);
26
+ return { content: [{ type: "text", text: `Device ${device_id} removed from the tailnet.` }] };
27
+ });
28
+ server.registerTool("set_device_tags", {
29
+ title: "Set Device Tags",
30
+ description: "Replace a device's ACL tags. Tags must already be defined in the tailnet's ACL policy under \"tagOwners\". Pass an empty array to clear all tags.",
31
+ inputSchema: {
32
+ device_id: z.string().describe("Tailscale device ID"),
33
+ tags: z.array(z.string()).describe('Full replacement tag list, e.g. ["tag:server", "tag:prod"]'),
34
+ },
35
+ }, async ({ device_id, tags }) => {
36
+ await client.post(`/device/${encodeURIComponent(device_id)}/tags`, { tags });
37
+ return { content: [{ type: "text", text: `Device ${device_id} tags set to: ${tags.join(", ") || "(none)"}` }] };
38
+ });
39
+ server.registerTool("expire_device_key", {
40
+ title: "Expire Device Key",
41
+ description: "Immediately expire a device's node key, disconnecting it from the tailnet. The device must re-authenticate to rejoin.",
42
+ inputSchema: {
43
+ device_id: z.string().describe("Tailscale device ID"),
44
+ },
45
+ }, async ({ device_id }) => {
46
+ await client.post(`/device/${encodeURIComponent(device_id)}/expire`);
47
+ return { content: [{ type: "text", text: `Device ${device_id} key expired — it must re-authenticate to reconnect.` }] };
48
+ });
49
+ server.registerTool("set_device_routes", {
50
+ title: "Set Device Routes",
51
+ description: "Set which of a device's advertised subnet routes are enabled (approved) in the tailnet. Pass the full replacement list of routes to enable.",
52
+ inputSchema: {
53
+ device_id: z.string().describe("Tailscale device ID"),
54
+ routes: z.array(z.string()).describe('Full replacement list of enabled routes, e.g. ["10.0.0.0/24"]'),
55
+ },
56
+ }, async ({ device_id, routes }) => {
57
+ await client.post(`/device/${encodeURIComponent(device_id)}/routes`, { routes });
58
+ return { content: [{ type: "text", text: `Enabled routes for device ${device_id}: ${routes.join(", ") || "(none)"}` }] };
59
+ });
60
+ server.registerTool("create_auth_key", {
61
+ title: "Create Auth Key",
62
+ description: "Create a new tailnet auth key that a new device can use to join without interactive login. The generated secret is returned once only.",
63
+ inputSchema: {
64
+ reusable: z.boolean().optional().default(false).describe("Allow the key to be used to authenticate multiple devices"),
65
+ ephemeral: z.boolean().optional().default(false).describe("Devices using this key are removed automatically when they go offline"),
66
+ preauthorized: z.boolean().optional().default(false).describe("Devices using this key skip manual authorization"),
67
+ expiry_seconds: z.number().int().positive().optional().describe("Key lifetime in seconds (default 90 days)"),
68
+ description: z.string().optional().describe("Human-readable description shown in the admin console"),
69
+ tags: z.array(z.string()).optional().describe("ACL tags to apply to devices created with this key, e.g. [\"tag:server\"]"),
70
+ },
71
+ }, async ({ reusable, ephemeral, preauthorized, expiry_seconds, description, tags }) => {
72
+ const capabilities = {
73
+ devices: {
74
+ create: {
75
+ reusable: reusable ?? false,
76
+ ephemeral: ephemeral ?? false,
77
+ preauthorized: preauthorized ?? false,
78
+ ...(tags && tags.length > 0 ? { tags } : {}),
79
+ },
80
+ },
81
+ };
82
+ const body = { capabilities };
83
+ if (expiry_seconds)
84
+ body["expirySeconds"] = expiry_seconds;
85
+ if (description)
86
+ body["description"] = description;
87
+ const key = await client.post(`/tailnet/${encodeURIComponent(client.tailnetName)}/keys`, body);
88
+ return { content: [{ type: "text", text: JSON.stringify(key, null, 2) }] };
89
+ });
90
+ server.registerTool("delete_auth_key", {
91
+ title: "Delete Auth Key",
92
+ description: "Revoke and delete an auth key so it can no longer be used to join the tailnet.",
93
+ inputSchema: {
94
+ key_id: z.string().describe("Auth key ID (from list_auth_keys)"),
95
+ },
96
+ }, async ({ key_id }) => {
97
+ await client.delete(`/tailnet/${encodeURIComponent(client.tailnetName)}/keys/${encodeURIComponent(key_id)}`);
98
+ return { content: [{ type: "text", text: `Auth key ${key_id} revoked.` }] };
99
+ });
100
+ server.registerTool("set_dns_nameservers", {
101
+ title: "Set DNS Nameservers",
102
+ description: "Replace the tailnet's global DNS nameserver list.",
103
+ inputSchema: {
104
+ dns: z.array(z.string()).describe('Full replacement list of nameserver IPs, e.g. ["8.8.8.8", "1.1.1.1"]'),
105
+ },
106
+ }, async ({ dns }) => {
107
+ await client.post(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/nameservers`, { dns });
108
+ return { content: [{ type: "text", text: `DNS nameservers set to: ${dns.join(", ") || "(none)"}` }] };
109
+ });
110
+ server.registerTool("set_dns_preferences", {
111
+ title: "Set DNS Preferences",
112
+ description: "Enable or disable MagicDNS for the tailnet.",
113
+ inputSchema: {
114
+ magic_dns: z.boolean().describe("true to enable MagicDNS, false to disable"),
115
+ },
116
+ }, async ({ magic_dns }) => {
117
+ await client.post(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/preferences`, {
118
+ magicDNS: magic_dns,
119
+ });
120
+ return { content: [{ type: "text", text: `MagicDNS ${magic_dns ? "enabled" : "disabled"}.` }] };
121
+ });
122
+ server.registerTool("set_dns_searchpaths", {
123
+ title: "Set DNS Search Paths",
124
+ description: "Replace the tailnet's DNS search paths.",
125
+ inputSchema: {
126
+ search_paths: z.array(z.string()).describe('Full replacement list of search domains, e.g. ["example.com"]'),
127
+ },
128
+ }, async ({ search_paths }) => {
129
+ await client.post(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/searchpaths`, {
130
+ searchPaths: search_paths,
131
+ });
132
+ return { content: [{ type: "text", text: `DNS search paths set to: ${search_paths.join(", ") || "(none)"}` }] };
133
+ });
134
+ server.registerTool("update_acl", {
135
+ title: "Update ACL",
136
+ description: "Replace the tailnet's access control policy file with new HuJSON content. " +
137
+ "Fetch the current policy with get_acl first, edit it, then pass the full replacement content — this is not a partial update. " +
138
+ "The API validates the policy and rejects invalid syntax or references to undefined tags/groups.",
139
+ inputSchema: {
140
+ acl_hujson: z.string().describe("Full replacement ACL policy file content, in HuJSON format"),
141
+ },
142
+ }, async ({ acl_hujson }) => {
143
+ const result = await client.postRaw(`/tailnet/${encodeURIComponent(client.tailnetName)}/acl`, acl_hujson, "application/hujson");
144
+ return { content: [{ type: "text", text: `ACL updated.\n${JSON.stringify(result, null, 2)}` }] };
145
+ });
146
+ }
147
+ //# sourceMappingURL=actions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/tools/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAuB;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,4HAA4H;QAC9H,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACrD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;SACrF;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;QAClC,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACzF,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,IAAI,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,GAAG,EAAE;aAC7F;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,sEAAsE;QACnF,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SACtD;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,4BAA4B,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,mJAAmJ;QACrJ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACrD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,4DAA4D,CAAC;SACjG;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,iBAAiB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;IAClH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uHAAuH;QACzH,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SACtD;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,SAAS,sDAAsD,EAAE,CAAC,EAAE,CAAC;IAC1H,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,6IAA6I;QAC/I,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YACrD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SACtG;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,kBAAkB,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,6BAA6B,SAAS,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3H,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,wIAAwI;QAC1I,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YACrH,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uEAAuE,CAAC;YAClI,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACjH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC5G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACpG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;SAC3H;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE;QAClF,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE;gBACP,MAAM,EAAE;oBACN,QAAQ,EAAE,QAAQ,IAAI,KAAK;oBAC3B,SAAS,EAAE,SAAS,IAAI,KAAK;oBAC7B,aAAa,EAAE,aAAa,IAAI,KAAK;oBACrC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7C;aACF;SACF,CAAC;QACF,MAAM,IAAI,GAA4B,EAAE,YAAY,EAAE,CAAC;QACvD,IAAI,cAAc;YAAE,IAAI,CAAC,eAAe,CAAC,GAAG,cAAc,CAAC;QAC3D,IAAI,WAAW;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,WAAW,CAAC;QAEnD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAC3B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EACzD,IAAI,CACL,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7G,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,MAAM,WAAW,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;SAC1G;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACjG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;IACxG,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SAC7E;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE;YACtF,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC;IAClG,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,yCAAyC;QACtD,WAAW,EAAE;YACX,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SAC5G;KACF,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACzB,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE;YACtF,WAAW,EAAE,YAAY;SAC1B,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;IAClH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,4EAA4E;YAC5E,+HAA+H;YAC/H,iGAAiG;QACnG,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;SAC9F;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CACjC,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EACxD,UAAU,EACV,oBAAoB,CACrB,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnG,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { TailscaleClient } from "../client.js";
3
+ export declare function registerDeviceTools(server: McpServer, client: TailscaleClient): void;
4
+ //# sourceMappingURL=devices.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA4DpF"}
@@ -0,0 +1,43 @@
1
+ import { z } from "zod";
2
+ export function registerDeviceTools(server, client) {
3
+ server.registerTool("list_devices", {
4
+ title: "List Devices",
5
+ description: "List all devices in the tailnet. Optionally filter by name/hostname substring or tag.",
6
+ inputSchema: {
7
+ name: z.string().optional().describe("Filter by device name or hostname — case-insensitive substring"),
8
+ tag: z.string().optional().describe("Filter to devices carrying this exact tag, e.g. tag:server"),
9
+ },
10
+ }, async ({ name, tag }) => {
11
+ const res = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/devices?fields=all`);
12
+ let devices = res.devices ?? [];
13
+ if (name) {
14
+ const needle = name.toLowerCase();
15
+ devices = devices.filter((d) => d.name.toLowerCase().includes(needle) || d.hostname.toLowerCase().includes(needle));
16
+ }
17
+ if (tag) {
18
+ devices = devices.filter((d) => (d.tags ?? []).includes(tag));
19
+ }
20
+ return { content: [{ type: "text", text: JSON.stringify(devices, null, 2) }] };
21
+ });
22
+ server.registerTool("get_device", {
23
+ title: "Get Device",
24
+ description: "Get full details for a single device by its Tailscale device ID.",
25
+ inputSchema: {
26
+ device_id: z.string().describe("Tailscale device ID (from list_devices)"),
27
+ },
28
+ }, async ({ device_id }) => {
29
+ const device = await client.get(`/device/${encodeURIComponent(device_id)}?fields=all`);
30
+ return { content: [{ type: "text", text: JSON.stringify(device, null, 2) }] };
31
+ });
32
+ server.registerTool("get_device_routes", {
33
+ title: "Get Device Routes",
34
+ description: "Get the subnet routes a device advertises and which of those are enabled (approved) in the tailnet.",
35
+ inputSchema: {
36
+ device_id: z.string().describe("Tailscale device ID"),
37
+ },
38
+ }, async ({ device_id }) => {
39
+ const routes = await client.get(`/device/${encodeURIComponent(device_id)}/routes`);
40
+ return { content: [{ type: "text", text: JSON.stringify(routes, null, 2) }] };
41
+ });
42
+ }
43
+ //# sourceMappingURL=devices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/tools/devices.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { TailscaleClient } from "../client.js";
3
+ export declare function registerDnsTools(server: McpServer, client: TailscaleClient): void;
4
+ //# sourceMappingURL=dns.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../src/tools/dns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CA6CjF"}
@@ -0,0 +1,27 @@
1
+ export function registerDnsTools(server, client) {
2
+ server.registerTool("get_dns_nameservers", {
3
+ title: "Get DNS Nameservers",
4
+ description: "Get the tailnet's global DNS nameservers (used for MagicDNS / split DNS).",
5
+ inputSchema: {},
6
+ }, async () => {
7
+ const res = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/nameservers`);
8
+ return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
9
+ });
10
+ server.registerTool("get_dns_preferences", {
11
+ title: "Get DNS Preferences",
12
+ description: "Get the tailnet's DNS preferences, including whether MagicDNS is enabled.",
13
+ inputSchema: {},
14
+ }, async () => {
15
+ const res = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/preferences`);
16
+ return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
17
+ });
18
+ server.registerTool("get_dns_searchpaths", {
19
+ title: "Get DNS Search Paths",
20
+ description: "Get the tailnet's DNS search paths.",
21
+ inputSchema: {},
22
+ }, async () => {
23
+ const res = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/dns/searchpaths`);
24
+ return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
25
+ });
26
+ }
27
+ //# sourceMappingURL=dns.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dns.js","sourceRoot":"","sources":["../../src/tools/dns.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CACrE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CACrE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CACrE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { TailscaleClient } from "../client.js";
3
+ export declare function registerKeyTools(server: McpServer, client: TailscaleClient): void;
4
+ //# sourceMappingURL=keys.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/tools/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAgCjF"}
@@ -0,0 +1,22 @@
1
+ import { z } from "zod";
2
+ export function registerKeyTools(server, client) {
3
+ server.registerTool("list_auth_keys", {
4
+ title: "List Auth Keys",
5
+ description: "List auth keys and OAuth clients for the tailnet (secret key material is not returned).",
6
+ inputSchema: {},
7
+ }, async () => {
8
+ const res = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/keys`);
9
+ return { content: [{ type: "text", text: JSON.stringify(res.keys ?? [], null, 2) }] };
10
+ });
11
+ server.registerTool("get_auth_key", {
12
+ title: "Get Auth Key",
13
+ description: "Get metadata for a single auth key by ID.",
14
+ inputSchema: {
15
+ key_id: z.string().describe("Auth key ID (from list_auth_keys)"),
16
+ },
17
+ }, async ({ key_id }) => {
18
+ const key = await client.get(`/tailnet/${encodeURIComponent(client.tailnetName)}/keys/${encodeURIComponent(key_id)}`);
19
+ return { content: [{ type: "text", text: JSON.stringify(key, null, 2) }] };
20
+ });
21
+ }
22
+ //# sourceMappingURL=keys.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/tools/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,yFAAyF;QACtG,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAC1D,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAC1B,YAAY,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,EAAE,CACxF,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,72 @@
1
+ export interface Device {
2
+ id: string;
3
+ nodeId: string;
4
+ name: string;
5
+ hostname: string;
6
+ clientVersion: string;
7
+ updateAvailable: boolean;
8
+ os: string;
9
+ created: string;
10
+ lastSeen: string;
11
+ keyExpiryDisabled: boolean;
12
+ expires: string;
13
+ authorized: boolean;
14
+ isExternal: boolean;
15
+ machineKey: string;
16
+ nodeKey: string;
17
+ blocksIncomingConnections: boolean;
18
+ enabledRoutes?: string[];
19
+ advertisedRoutes?: string[];
20
+ clientConnectivity?: unknown;
21
+ tags?: string[];
22
+ addresses: string[];
23
+ user: string;
24
+ tailnetLockError?: string;
25
+ tailnetLockKey?: string;
26
+ }
27
+ export interface DevicesResponse {
28
+ devices: Device[];
29
+ }
30
+ export interface DeviceRoutes {
31
+ advertisedRoutes: string[];
32
+ enabledRoutes: string[];
33
+ }
34
+ export interface AuthKey {
35
+ id: string;
36
+ key?: string;
37
+ created: string;
38
+ expires: string;
39
+ revoked?: string;
40
+ invalidated?: boolean;
41
+ capabilities: unknown;
42
+ description?: string;
43
+ invalid?: boolean;
44
+ userId?: string;
45
+ tags?: string[];
46
+ }
47
+ export interface AuthKeysResponse {
48
+ keys: AuthKey[];
49
+ }
50
+ export interface DnsNameserversResponse {
51
+ dns: string[];
52
+ }
53
+ export interface DnsPreferencesResponse {
54
+ magicDNS: boolean;
55
+ }
56
+ export interface DnsSearchPathsResponse {
57
+ searchPaths: string[];
58
+ }
59
+ export interface WebhookEndpoint {
60
+ endpointId: string;
61
+ endpointUrl: string;
62
+ providerType?: string;
63
+ creatorLoginName?: string;
64
+ created?: string;
65
+ lastStartedAt?: string;
66
+ subscriptions: string[];
67
+ secret?: string;
68
+ }
69
+ export interface WebhooksResponse {
70
+ webhooks: WebhookEndpoint[];
71
+ }
72
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB,EAAE,OAAO,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B"}
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
package/package.json ADDED
@@ -0,0 +1,30 @@
1
+ {
2
+ "name": "@teamnetwork-nz/tailscale-mcp-server",
3
+ "version": "1.0.0",
4
+ "description": "MCP server for the Tailscale API — manage devices, ACLs, DNS, subnet routes, and auth keys",
5
+ "keywords": ["mcp", "tailscale", "vpn", "networking", "claude"],
6
+ "license": "MIT",
7
+ "type": "module",
8
+ "bin": {
9
+ "tailscale-mcp-server": "./dist/index.js"
10
+ },
11
+ "main": "./dist/index.js",
12
+ "files": ["dist"],
13
+ "scripts": {
14
+ "build": "tsc",
15
+ "dev": "tsc --watch",
16
+ "start": "node dist/index.js",
17
+ "prepublishOnly": "npm run build"
18
+ },
19
+ "dependencies": {
20
+ "@modelcontextprotocol/sdk": "^1.11.0",
21
+ "zod": "^3.24.0"
22
+ },
23
+ "devDependencies": {
24
+ "@types/node": "^18.19.0",
25
+ "typescript": "^5.4.0"
26
+ },
27
+ "engines": {
28
+ "node": ">=18"
29
+ }
30
+ }