@node2flow/telegram-bot-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Node2Flow
+
+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,181 @@
+# Telegram Bot MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@node2flow/telegram-bot-mcp.svg)](https://www.npmjs.com/package/@node2flow/telegram-bot-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP (Model Context Protocol) server for Telegram Bot API. Send messages, manage chats, handle webhooks, and more through 27 tools.
+
+Works with Claude Desktop, Cursor, VS Code, and any MCP client.
+
+---
+
+## Quick Start
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "npx",
+      "args": ["-y", "@node2flow/telegram-bot-mcp"],
+      "env": {
+        "TELEGRAM_BOT_TOKEN": "your-bot-token"
+      }
+    }
+  }
+}
+```
+
+### Cursor / VS Code
+
+Add to MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "npx",
+      "args": ["-y", "@node2flow/telegram-bot-mcp"],
+      "env": {
+        "TELEGRAM_BOT_TOKEN": "your-bot-token"
+      }
+    }
+  }
+}
+```
+
+### HTTP Mode (Streamable HTTP)
+
+For remote deployment or shared access:
+
+```bash
+TELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp --http
+```
+
+Server starts on port 3000 (configurable via `PORT` env var). MCP endpoint: `http://localhost:3000/mcp`
+
+---
+
+## Configuration
+
+| Environment Variable | Required | Description |
+|---|---|---|
+| `TELEGRAM_BOT_TOKEN` | Yes | Telegram Bot token from [@BotFather](https://t.me/BotFather) |
+| `PORT` | No | Port for HTTP server (default: `3000`, only used with `--http`) |
+
+---
+
+## All Tools (27 tools)
+
+### Bot Info (2 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_get_me` | Get bot information |
+| `tg_set_my_commands` | Set bot command menu |
+
+### Send Messages (8 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_send_message` | Send text with Markdown/HTML formatting |
+| `tg_send_photo` | Send photo (URL or file_id) |
+| `tg_send_document` | Send document/file (max 50MB) |
+| `tg_send_video` | Send video (MPEG4, max 50MB) |
+| `tg_send_audio` | Send audio (MP3/M4A, max 50MB) |
+| `tg_send_location` | Send geographic location |
+| `tg_send_poll` | Send poll (regular or quiz) |
+| `tg_send_contact` | Send phone contact card |
+
+### Edit/Delete (3 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_edit_message_text` | Edit message text |
+| `tg_edit_message_caption` | Edit media caption |
+| `tg_delete_message` | Delete a message (48hr limit) |
+
+### Chat Management (5 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_get_chat` | Get chat details |
+| `tg_get_chat_member_count` | Get member count |
+| `tg_get_chat_member` | Get member info |
+| `tg_ban_chat_member` | Ban user from chat |
+| `tg_unban_chat_member` | Unban user |
+
+### Webhooks (3 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_set_webhook` | Set webhook URL |
+| `tg_delete_webhook` | Remove webhook |
+| `tg_get_webhook_info` | Get webhook status |
+
+### Callbacks & Files (3 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_answer_callback_query` | Answer inline button press |
+| `tg_get_file` | Get file download URL |
+| `tg_get_user_profile_photos` | Get user profile photos |
+
+### Pins & Invite Links (3 tools)
+
+| Tool | Description |
+|---|---|
+| `tg_pin_chat_message` | Pin a message |
+| `tg_unpin_chat_message` | Unpin a message |
+| `tg_create_chat_invite_link` | Create invite link |
+
+---
+
+## Requirements
+
+- **Node.js** 18+
+- **Telegram Bot token**
+
+### How to Create a Telegram Bot
+
+1. Open [@BotFather](https://t.me/BotFather) on Telegram
+2. Send `/newbot` and follow the prompts
+3. Copy the token and use it as `TELEGRAM_BOT_TOKEN`
+
+---
+
+## For Developers
+
+```bash
+git clone https://github.com/node2flow-th/telegram-bot-mcp-community.git
+cd telegram-bot-mcp-community
+npm install
+npm run build
+
+# Run in stdio mode
+TELEGRAM_BOT_TOKEN=your_token npm start
+
+# Run in dev mode (hot reload)
+TELEGRAM_BOT_TOKEN=your_token npm run dev
+
+# Run in HTTP mode
+TELEGRAM_BOT_TOKEN=your_token npm start -- --http
+```
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE)
+
+Copyright (c) 2026 [Node2Flow](https://node2flow.net)
+
+## Links
+
+- [npm Package](https://www.npmjs.com/package/@node2flow/telegram-bot-mcp)
+- [Telegram Bot API](https://core.telegram.org/bots/api)
+- [MCP Protocol](https://modelcontextprotocol.io/)
+- [Node2Flow](https://node2flow.net)

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Telegram Bot API Client
+ * Token is embedded in the URL path: https://api.telegram.org/bot{TOKEN}/method
+ * Responses are wrapped in { ok: true, result: ... } and auto-unwrapped.
+ */
+import type { TelegramConfig, TelegramUser, TelegramMessage, TelegramChat, TelegramChatMember, TelegramFile, TelegramUserProfilePhotos, TelegramWebhookInfo, TelegramChatInviteLink, TelegramBotCommand } from './types.js';
+export declare class TelegramClient {
+    private config;
+    private baseUrl;
+    constructor(config: TelegramConfig);
+    private request;
+    getMe(): Promise<TelegramUser>;
+    setMyCommands(commands: TelegramBotCommand[], scope?: Record<string, unknown>, languageCode?: string): Promise<boolean>;
+    sendMessage(chatId: string | number, text: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendPhoto(chatId: string | number, photo: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendDocument(chatId: string | number, document: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendVideo(chatId: string | number, video: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendAudio(chatId: string | number, audio: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendLocation(chatId: string | number, latitude: number, longitude: number, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendPoll(chatId: string | number, question: string, options: string[], opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    sendContact(chatId: string | number, phoneNumber: string, firstName: string, opts?: Record<string, unknown>): Promise<TelegramMessage>;
+    editMessageText(chatId: string | number, messageId: number, text: string, opts?: Record<string, unknown>): Promise<TelegramMessage | boolean>;
+    editMessageCaption(chatId: string | number, messageId: number, opts?: Record<string, unknown>): Promise<TelegramMessage | boolean>;
+    deleteMessage(chatId: string | number, messageId: number): Promise<boolean>;
+    getChat(chatId: string | number): Promise<TelegramChat>;
+    getChatMemberCount(chatId: string | number): Promise<number>;
+    getChatMember(chatId: string | number, userId: number): Promise<TelegramChatMember>;
+    banChatMember(chatId: string | number, userId: number, opts?: Record<string, unknown>): Promise<boolean>;
+    unbanChatMember(chatId: string | number, userId: number, opts?: Record<string, unknown>): Promise<boolean>;
+    setWebhook(url: string, opts?: Record<string, unknown>): Promise<boolean>;
+    deleteWebhook(opts?: Record<string, unknown>): Promise<boolean>;
+    getWebhookInfo(): Promise<TelegramWebhookInfo>;
+    answerCallbackQuery(callbackQueryId: string, opts?: Record<string, unknown>): Promise<boolean>;
+    getFile(fileId: string): Promise<TelegramFile & {
+        download_url: string;
+    }>;
+    getUserProfilePhotos(userId: number, opts?: Record<string, unknown>): Promise<TelegramUserProfilePhotos>;
+    pinChatMessage(chatId: string | number, messageId: number, opts?: Record<string, unknown>): Promise<boolean>;
+    unpinChatMessage(chatId: string | number, messageId?: number): Promise<boolean>;
+    createChatInviteLink(chatId: string | number, opts?: Record<string, unknown>): Promise<TelegramChatInviteLink>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,151 @@
+/**
+ * Telegram Bot API Client
+ * Token is embedded in the URL path: https://api.telegram.org/bot{TOKEN}/method
+ * Responses are wrapped in { ok: true, result: ... } and auto-unwrapped.
+ */
+export class TelegramClient {
+    config;
+    baseUrl = 'https://api.telegram.org';
+    constructor(config) {
+        this.config = config;
+    }
+    async request(method, body) {
+        const url = `${this.baseUrl}/bot${this.config.botToken}/${method}`;
+        const options = {};
+        if (body) {
+            options.method = 'POST';
+            options.headers = { 'Content-Type': 'application/json' };
+            options.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, options);
+        const data = (await response.json());
+        if (!data.ok) {
+            throw new Error(`Telegram API Error (${data.error_code}): ${data.description}`);
+        }
+        return data.result;
+    }
+    // ========== Bot Info ==========
+    async getMe() {
+        return this.request('getMe');
+    }
+    async setMyCommands(commands, scope, languageCode) {
+        const body = { commands };
+        if (scope)
+            body.scope = scope;
+        if (languageCode)
+            body.language_code = languageCode;
+        return this.request('setMyCommands', body);
+    }
+    // ========== Send Messages ==========
+    async sendMessage(chatId, text, opts) {
+        return this.request('sendMessage', { chat_id: chatId, text, ...opts });
+    }
+    async sendPhoto(chatId, photo, opts) {
+        return this.request('sendPhoto', { chat_id: chatId, photo, ...opts });
+    }
+    async sendDocument(chatId, document, opts) {
+        return this.request('sendDocument', { chat_id: chatId, document, ...opts });
+    }
+    async sendVideo(chatId, video, opts) {
+        return this.request('sendVideo', { chat_id: chatId, video, ...opts });
+    }
+    async sendAudio(chatId, audio, opts) {
+        return this.request('sendAudio', { chat_id: chatId, audio, ...opts });
+    }
+    async sendLocation(chatId, latitude, longitude, opts) {
+        return this.request('sendLocation', { chat_id: chatId, latitude, longitude, ...opts });
+    }
+    async sendPoll(chatId, question, options, opts) {
+        return this.request('sendPoll', { chat_id: chatId, question, options, ...opts });
+    }
+    async sendContact(chatId, phoneNumber, firstName, opts) {
+        return this.request('sendContact', {
+            chat_id: chatId,
+            phone_number: phoneNumber,
+            first_name: firstName,
+            ...opts,
+        });
+    }
+    // ========== Edit/Delete Messages ==========
+    async editMessageText(chatId, messageId, text, opts) {
+        return this.request('editMessageText', {
+            chat_id: chatId,
+            message_id: messageId,
+            text,
+            ...opts,
+        });
+    }
+    async editMessageCaption(chatId, messageId, opts) {
+        return this.request('editMessageCaption', {
+            chat_id: chatId,
+            message_id: messageId,
+            ...opts,
+        });
+    }
+    async deleteMessage(chatId, messageId) {
+        return this.request('deleteMessage', { chat_id: chatId, message_id: messageId });
+    }
+    // ========== Chat Management ==========
+    async getChat(chatId) {
+        return this.request('getChat', { chat_id: chatId });
+    }
+    async getChatMemberCount(chatId) {
+        return this.request('getChatMemberCount', { chat_id: chatId });
+    }
+    async getChatMember(chatId, userId) {
+        return this.request('getChatMember', { chat_id: chatId, user_id: userId });
+    }
+    async banChatMember(chatId, userId, opts) {
+        return this.request('banChatMember', { chat_id: chatId, user_id: userId, ...opts });
+    }
+    async unbanChatMember(chatId, userId, opts) {
+        return this.request('unbanChatMember', { chat_id: chatId, user_id: userId, ...opts });
+    }
+    // ========== Webhooks ==========
+    async setWebhook(url, opts) {
+        return this.request('setWebhook', { url, ...opts });
+    }
+    async deleteWebhook(opts) {
+        return this.request('deleteWebhook', opts || {});
+    }
+    async getWebhookInfo() {
+        return this.request('getWebhookInfo');
+    }
+    // ========== Callbacks & Files ==========
+    async answerCallbackQuery(callbackQueryId, opts) {
+        return this.request('answerCallbackQuery', {
+            callback_query_id: callbackQueryId,
+            ...opts,
+        });
+    }
+    async getFile(fileId) {
+        const file = await this.request('getFile', { file_id: fileId });
+        return {
+            ...file,
+            download_url: file.file_path
+                ? `${this.baseUrl}/file/bot${this.config.botToken}/${file.file_path}`
+                : '',
+        };
+    }
+    async getUserProfilePhotos(userId, opts) {
+        return this.request('getUserProfilePhotos', { user_id: userId, ...opts });
+    }
+    // ========== Pins & Invite Links ==========
+    async pinChatMessage(chatId, messageId, opts) {
+        return this.request('pinChatMessage', {
+            chat_id: chatId,
+            message_id: messageId,
+            ...opts,
+        });
+    }
+    async unpinChatMessage(chatId, messageId) {
+        const body = { chat_id: chatId };
+        if (messageId !== undefined)
+            body.message_id = messageId;
+        return this.request('unpinChatMessage', body);
+    }
+    async createChatInviteLink(chatId, opts) {
+        return this.request('createChatInviteLink', { chat_id: chatId, ...opts });
+    }
+}
+//# 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/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Telegram Bot MCP Server
+ *
+ * Community edition — connects directly to Telegram Bot API.
+ *
+ * Usage (stdio - for Claude Desktop / Cursor / VS Code):
+ *   TELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp
+ *
+ * Usage (HTTP - Streamable HTTP transport):
+ *   TELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp --http
+ */
+/**
+ * Smithery default export
+ */
+export default function createSmitheryServer(opts?: {
+    config?: {
+        TELEGRAM_BOT_TOKEN?: string;
+    };
+}): import("@modelcontextprotocol/sdk/server/mcp.js").McpServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAoKH;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,+DAI/F"}

package/dist/index.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * Telegram Bot MCP Server
+ *
+ * Community edition — connects directly to Telegram Bot API.
+ *
+ * Usage (stdio - for Claude Desktop / Cursor / VS Code):
+ *   TELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp
+ *
+ * Usage (HTTP - Streamable HTTP transport):
+ *   TELEGRAM_BOT_TOKEN=your_token npx @node2flow/telegram-bot-mcp --http
+ */
+import { randomUUID } from 'node:crypto';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport, } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { createServer } from './server.js';
+import { TOOLS } from './tools.js';
+/**
+ * Read config from environment variables
+ */
+function getConfig() {
+    const botToken = process.env.TELEGRAM_BOT_TOKEN;
+    if (!botToken) {
+        return null;
+    }
+    return { botToken };
+}
+/**
+ * Start in stdio mode (for Claude Desktop, Cursor, VS Code)
+ */
+async function startStdio() {
+    const config = getConfig();
+    const server = createServer(config ?? undefined);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Telegram Bot MCP Server running on stdio');
+    console.error(`Bot token: ${config ? '***configured***' : '(not configured yet)'}`);
+    console.error(`Tools available: ${TOOLS.length}`);
+    console.error('Ready for MCP client\n');
+}
+/**
+ * Start in HTTP mode (Streamable HTTP transport)
+ */
+async function startHttp() {
+    const port = parseInt(process.env.PORT || '3000', 10);
+    const app = createMcpExpressApp({ host: '0.0.0.0' });
+    const transports = {};
+    app.post('/mcp', async (req, res) => {
+        const url = new URL(req.url, `http://${req.headers.host}`);
+        const qToken = url.searchParams.get('TELEGRAM_BOT_TOKEN');
+        if (qToken)
+            process.env.TELEGRAM_BOT_TOKEN = qToken;
+        const sessionId = req.headers['mcp-session-id'];
+        try {
+            let transport;
+            if (sessionId && transports[sessionId]) {
+                transport = transports[sessionId];
+            }
+            else if (!sessionId && isInitializeRequest(req.body)) {
+                transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (sid) => {
+                        transports[sid] = transport;
+                    },
+                });
+                transport.onclose = () => {
+                    const sid = transport.sessionId;
+                    if (sid && transports[sid]) {
+                        delete transports[sid];
+                    }
+                };
+                const config = getConfig();
+                const server = createServer(config ?? undefined);
+                await server.connect(transport);
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+            else {
+                res.status(400).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32000, message: 'Bad Request: No valid session ID provided' },
+                    id: null,
+                });
+                return;
+            }
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error('Error handling MCP request:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32603, message: 'Internal server error' },
+                    id: null,
+                });
+            }
+        }
+    });
+    app.get('/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !transports[sessionId]) {
+            res.status(400).send('Invalid or missing session ID');
+            return;
+        }
+        await transports[sessionId].handleRequest(req, res);
+    });
+    app.delete('/mcp', async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !transports[sessionId]) {
+            res.status(400).send('Invalid or missing session ID');
+            return;
+        }
+        await transports[sessionId].handleRequest(req, res);
+    });
+    app.get('/', (_req, res) => {
+        res.json({
+            name: 'telegram-bot-mcp',
+            version: '1.0.0',
+            status: 'ok',
+            tools: TOOLS.length,
+            transport: 'streamable-http',
+            endpoints: { mcp: '/mcp' },
+        });
+    });
+    const config = getConfig();
+    app.listen(port, () => {
+        console.log(`Telegram Bot MCP Server (HTTP) listening on port ${port}`);
+        console.log(`Bot token: ${config ? '***configured***' : '(not configured yet)'}`);
+        console.log(`Tools available: ${TOOLS.length}`);
+        console.log(`MCP endpoint: http://localhost:${port}/mcp`);
+    });
+    process.on('SIGINT', async () => {
+        console.log('\nShutting down...');
+        for (const sessionId in transports) {
+            try {
+                await transports[sessionId].close();
+                delete transports[sessionId];
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        process.exit(0);
+    });
+}
+async function main() {
+    const useHttp = process.argv.includes('--http');
+    if (useHttp) {
+        await startHttp();
+    }
+    else {
+        await startStdio();
+    }
+}
+/**
+ * Smithery default export
+ */
+export default function createSmitheryServer(opts) {
+    if (opts?.config?.TELEGRAM_BOT_TOKEN)
+        process.env.TELEGRAM_BOT_TOKEN = opts.config.TELEGRAM_BOT_TOKEN;
+    const config = getConfig();
+    return createServer(config ?? undefined);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# 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.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared MCP Server — used by both Node.js (index.ts) and CF Worker (worker.ts)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TelegramClient } from './client.js';
+export interface TelegramMcpConfig {
+    botToken: string;
+}
+export declare function handleToolCall(toolName: string, args: Record<string, unknown>, client: TelegramClient): Promise<import("./types.js").TelegramUser> | Promise<boolean | import("./types.js").TelegramMessage> | Promise<import("./types.js").TelegramChat> | Promise<number> | Promise<import("./types.js").TelegramChatMember> | Promise<import("./types.js").TelegramWebhookInfo> | Promise<import("./types.js").TelegramFile & {
+    download_url: string;
+}> | Promise<import("./types.js").TelegramUserProfilePhotos> | Promise<import("./types.js").TelegramChatInviteLink>;
+export declare function createServer(config?: TelegramMcpConfig): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,cAAc;;oHAoHvB;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,iBAAiB,aA8CtD"}