@mirid-dev/sendkit-mcp-tools 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ky-Ling
+
+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

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @mirid-dev/sendkit-mcp-tools
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[MCP](https://modelcontextprotocol.io) tool definitions for SendKit, shared by its local and remote MCP servers.
+
+Requires Node.js 20 or later. ESM only.
+
+## Install
+
+```sh
+npm install @mirid-dev/sendkit-mcp-tools @modelcontextprotocol/server
+```
+
+## Usage
+
+```ts
+import { McpServer } from '@modelcontextprotocol/server'
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio'
+import { registerTelegramTool } from '@mirid-dev/sendkit-mcp-tools'
+
+const server = new McpServer({ name: 'my-server', version: '1.0.0' })
+
+registerTelegramTool(server, () => process.env.TELEGRAM_BOT_TOKEN ?? '')
+
+await server.connect(new StdioServerTransport())
+```
+
+`registerTelegramTool(server, getBotToken)` registers a `telegram` tool that takes `chatId` and `message` and returns `messageId`, `chatId`, and `sentAt`. `getBotToken` is called on every tool call, so a missing token fails that call instead of server startup.
+
+For a ready-to-run server, use [`@mirid-dev/sendkit-local-mcp`](https://www.npmjs.com/package/@mirid-dev/sendkit-local-mcp).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/server";
+export declare function registerTelegramTool(server: McpServer, getBotToken: () => string): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";wBAegB,qBAAqB,QAAQ,WAAW"}

package/dist/index.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { sendTelegramMessage, telegramMessageInputSchema, telegramMessageOutputSchema } from "@mirid-dev/sendkit-core";
+// src/index.ts
+const telegramToolOutputSchema = telegramMessageOutputSchema.extend({ sentAt: z.iso.datetime() });
+function registerTelegramTool(server, getBotToken) {
+	server.registerTool("telegram", {
+		title: "Telegram",
+		description: "Send a Telegram message",
+		inputSchema: telegramMessageInputSchema,
+		outputSchema: telegramToolOutputSchema
+	}, async (input) => {
+		const result = await sendTelegramMessage({
+			...input,
+			botToken: getBotToken()
+		});
+		const output = {
+			...result,
+			sentAt: result.sentAt.toISOString()
+		};
+		return {
+			content: [{
+				type: "text",
+				text: `Sent Telegram message ${output.messageId} to chat ${output.chatId}`
+			}],
+			structuredContent: output
+		};
+	});
+}
+export { registerTelegramTool };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/server'\nimport { z } from 'zod'\n\nimport {\n  sendTelegramMessage,\n  telegramMessageInputSchema,\n  telegramMessageOutputSchema,\n} from '@mirid-dev/sendkit-core'\n\n// Structured content travels as JSON, so the Date becomes an ISO string\nconst telegramToolOutputSchema = telegramMessageOutputSchema.extend({\n  sentAt: z.iso.datetime(),\n})\n\n// getBotToken runs per call, so a missing token fails the call rather than server startup\nexport function registerTelegramTool(server: McpServer, getBotToken: () => string) {\n  server.registerTool(\n    'telegram',\n    {\n      title: 'Telegram',\n      description: 'Send a Telegram message',\n      inputSchema: telegramMessageInputSchema,\n      outputSchema: telegramToolOutputSchema,\n    },\n    async (input) => {\n      const result = await sendTelegramMessage({\n        ...input,\n        botToken: getBotToken(),\n      })\n\n      const output = { ...result, sentAt: result.sentAt.toISOString() }\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Sent Telegram message ${output.messageId} to chat ${output.chatId}`,\n          },\n        ],\n        structuredContent: output,\n      }\n    },\n  )\n}\n"],"mappings":";;;AAUA,MAAM,2BAA2B,4BAA4B,OAAO,EAClE,QAAQ,EAAE,IAAI,SAAS,EACzB,CAAC;AAGD,SAAgB,qBAAqB,QAAmB,aAA2B;CACjF,OAAO,aACL,YACA;EACE,OAAO;EACP,aAAa;EACb,aAAa;EACb,cAAc;CAChB,GACA,OAAO,UAAU;EACf,MAAM,SAAS,MAAM,oBAAoB;GACvC,GAAG;GACH,UAAU,YAAY;EACxB,CAAC;EAED,MAAM,SAAS;GAAE,GAAG;GAAQ,QAAQ,OAAO,OAAO,YAAY;EAAE;EAEhE,OAAO;GACL,SAAS,CACP;IACE,MAAM;IACN,MAAM,yBAAyB,OAAO,UAAU,WAAW,OAAO;GACpE,CACF;GACA,mBAAmB;EACrB;CACF,CACF;AACF"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@mirid-dev/sendkit-mcp-tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "MCP tool definitions for SendKit, shared by its local and remote MCP servers",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ky-Ling/sendkit.git",
+    "directory": "packages/mcp-tools"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "pack:dry": "bun run build && bun pm pack --dry-run",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@mirid-dev/sendkit-core": "0.0.1",
+    "@modelcontextprotocol/server": "^2.4.0",
+    "zod": "^4.6.7"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+import type { McpServer } from '@modelcontextprotocol/server'
+import { z } from 'zod'
+
+import {
+  sendTelegramMessage,
+  telegramMessageInputSchema,
+  telegramMessageOutputSchema,
+} from '@mirid-dev/sendkit-core'
+
+// Structured content travels as JSON, so the Date becomes an ISO string
+const telegramToolOutputSchema = telegramMessageOutputSchema.extend({
+  sentAt: z.iso.datetime(),
+})
+
+// getBotToken runs per call, so a missing token fails the call rather than server startup
+export function registerTelegramTool(server: McpServer, getBotToken: () => string) {
+  server.registerTool(
+    'telegram',
+    {
+      title: 'Telegram',
+      description: 'Send a Telegram message',
+      inputSchema: telegramMessageInputSchema,
+      outputSchema: telegramToolOutputSchema,
+    },
+    async (input) => {
+      const result = await sendTelegramMessage({
+        ...input,
+        botToken: getBotToken(),
+      })
+
+      const output = { ...result, sentAt: result.sentAt.toISOString() }
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Sent Telegram message ${output.messageId} to chat ${output.chatId}`,
+          },
+        ],
+        structuredContent: output,
+      }
+    },
+  )
+}