bn-telegram-mcp-server 0.0.1

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAGD;;;;;;GAMG;AAGH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAGF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAC1C,CAAC,EAAE,SAAS,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAGF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,CAAC,EAAE,OAAO,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAGF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,CAAC,EAAE,OAAO,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "bn-telegram-mcp-server",
+  "version": "0.0.1",
+  "description": "Stateless MCP Server for Telegram via TDLib",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bn-telegram-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "nodemon",
+    "dev:debug": "DEBUG=true nodemon",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "telegram",
+    "tdlib",
+    "stateless"
+  ],
+  "author": "BlueNexus AI",
+  "license": "PROPRIETARY",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "express": "^4.21.2",
+    "tdl": "^8.0.0",
+    "prebuilt-tdlib": "^0.1008057.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.2",
+    "nodemon": "^3.1.10",
+    "typescript": "^5.8.3"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "tools.json"
+  ],
+  "packageManager": "pnpm@10.22.0"
+}

package/tools.json

@@ -0,0 +1,252 @@
+{
+  "getMe": {
+    "name": "getMe",
+    "description": "Get information about the current Telegram user (the authenticated user). Returns name, username, phone, status, and profile info.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  "getChat": {
+    "name": "getChat",
+    "description": "Get chat information - either list all chats or get details for a specific chat. If 'chat' parameter is provided, returns single chat info. If omitted, returns list of all chats.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat": {
+          "type": ["number", "string"],
+          "description": "Optional - Chat identifier (numeric ID or title/name to search). If not provided, lists all chats."
+        },
+        "chat_list": {
+          "type": "string",
+          "enum": ["main", "archive"],
+          "description": "Which chat list to retrieve (default: main)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum number of chats to return when listing (default: 100, max: 4000)"
+        }
+      }
+    }
+  },
+  "getMessages": {
+    "name": "getMessages",
+    "description": "Get messages from a chat - supports history, specific IDs, or search. Use 'mode' parameter to choose: 'history' for paginated history, 'specific' for exact message IDs, 'search' for text search.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat": {
+          "type": ["number", "string"],
+          "description": "Chat identifier (required for history and specific modes, optional for search)"
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["history", "specific", "search"],
+          "description": "Mode: 'history' for paginated history, 'specific' for exact message IDs, 'search' for text search (default: history)"
+        },
+        "from_message_id": {
+          "type": "number",
+          "description": "(history/chat search mode) Message ID to start from (0 for latest)"
+        },
+        "offset": {
+          "type": "number",
+          "description": "(history mode) Numeric offset for pagination"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum messages to return (default: 50, max: 100)"
+        },
+        "only_local": {
+          "type": "boolean",
+          "description": "(history mode) Only return locally cached messages"
+        },
+        "message_ids": {
+          "type": "array",
+          "items": { "type": "number" },
+          "description": "(specific mode) Array of message IDs to retrieve"
+        },
+        "query": {
+          "type": "string",
+          "description": "(search mode) Search query text"
+        },
+        "next_offset": {
+          "type": "string",
+          "description": "(search mode) Cursor for pagination - pass the next_offset from previous response"
+        }
+      }
+    }
+  },
+  "sendMessage": {
+    "name": "sendMessage",
+    "description": "Send or forward messages to a chat. Use 'action' parameter: 'send' to compose new message, 'forward' to forward existing messages from another chat.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat": {
+          "type": ["number", "string"],
+          "description": "Target chat to send/forward to (numeric ID or chat title/name)"
+        },
+        "action": {
+          "type": "string",
+          "enum": ["send", "forward"],
+          "description": "Action: 'send' to compose new message, 'forward' to forward existing messages (default: send)"
+        },
+        "text": {
+          "type": "string",
+          "description": "(send action) Text content of the message"
+        },
+        "reply_to_message_id": {
+          "type": "number",
+          "description": "(send action) ID of message to reply to"
+        },
+        "from_chat": {
+          "type": ["number", "string"],
+          "description": "(forward action) Source chat to forward from"
+        },
+        "message_ids": {
+          "type": "array",
+          "items": { "type": "number" },
+          "description": "(forward action) Array of message IDs to forward"
+        },
+        "send_copy": {
+          "type": "boolean",
+          "description": "(forward action) Send copies without forwarding header"
+        },
+        "remove_caption": {
+          "type": "boolean",
+          "description": "(forward action) Remove media captions when forwarding"
+        }
+      },
+      "required": ["chat"]
+    }
+  },
+  "getUser": {
+    "name": "getUser",
+    "description": "Get information about a Telegram user. You can use their name (e.g., 'Gong', 'John Doe') or numeric user ID.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "user": {
+          "type": ["number", "string"],
+          "description": "User identifier: name (e.g., 'John Doe') or numeric user ID"
+        }
+      },
+      "required": ["user"]
+    }
+  },
+  "getContacts": {
+    "name": "getContacts",
+    "description": "Get contacts - list all or search by name/username. If 'query' is provided, searches contacts. If omitted, returns all contacts.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Optional - Search query to filter contacts. If not provided, returns all contacts"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum results when searching (default: 50, max: 200)"
+        }
+      }
+    }
+  },
+  "getFile": {
+    "name": "getFile",
+    "description": "Get file metadata (size, remote ID). Note: Download is not supported in stateless mode.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "file_id": {
+          "type": "number",
+          "description": "Identifier of the file to get metadata for"
+        }
+      },
+      "required": ["file_id"]
+    }
+  },
+  "getGroup": {
+    "name": "getGroup",
+    "description": "Get group information - supports basic groups, supergroups, and channels. Use 'type' parameter: 'auto' to detect automatically, 'supergroup' for supergroups/channels, 'basic_group' for basic groups.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "group": {
+          "type": ["number", "string"],
+          "description": "Group identifier (numeric ID or group name)"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["auto", "supergroup", "basic_group"],
+          "description": "Group type: 'auto' to detect, 'supergroup', or 'basic_group' (default: auto)"
+        }
+      },
+      "required": ["group"]
+    }
+  },
+  "getChatMembers": {
+    "name": "getChatMembers",
+    "description": "Get members of a chat - supports filtering by role or search. Use 'filter' parameter: 'recent', 'administrators', 'banned', 'bots', or 'search'.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat": {
+          "type": ["number", "string"],
+          "description": "Chat identifier (numeric ID or chat title)"
+        },
+        "filter": {
+          "type": "string",
+          "enum": ["recent", "administrators", "banned", "bots", "search"],
+          "description": "Filter type: 'recent', 'administrators', 'banned', 'bots', or 'search' (default: recent)"
+        },
+        "query": {
+          "type": "string",
+          "description": "Search query (only used with 'search' and 'banned' filters)"
+        },
+        "offset": {
+          "type": "number",
+          "description": "Pagination offset (default: 0)"
+        },
+        "limit": {
+          "type": "number",
+          "description": "Maximum members to return (default: 200, max: 200)"
+        }
+      },
+      "required": ["chat"]
+    }
+  },
+  "getMessageContext": {
+    "name": "getMessageContext",
+    "description": "Get surrounding messages for context around a specific message or search results. Returns messages before and after the target to understand the full conversation flow. Use 'mode' parameter: 'message_id' to get context around a known message, 'search' to find messages and get context around each match.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "chat": {
+          "type": ["number", "string"],
+          "description": "Chat identifier (required for message_id mode, optional for search mode - global search if omitted)"
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["message_id", "search"],
+          "description": "Mode: 'message_id' to get context around a specific message, 'search' to find messages and get context (default: message_id)"
+        },
+        "message_id": {
+          "type": "number",
+          "description": "(message_id mode) The message ID to get context around"
+        },
+        "query": {
+          "type": "string",
+          "description": "(search mode) Search query to find messages"
+        },
+        "search_limit": {
+          "type": "number",
+          "description": "(search mode) Maximum search results to get context for (default: 5, max: 20)"
+        },
+        "context_count": {
+          "type": "number",
+          "description": "Number of messages to fetch before AND after the target message (default: 5, max: 50)"
+        }
+      }
+    }
+  }
+}