Telegram MCP Server

Instructions

Implementation Reference

• src/server-api-handlers.ts:203-251 (handler)

  The handler function that implements the core logic of the 'api_get_channel_info' tool: checks API connection, parses channel URL, retrieves channel information using the Telegram API client, and returns formatted details.

    async handleApiGetChannelInfo(this: any, args: any): Promise<any> {
      if (!this._apiScraper || !this._apiScraper.isConnected()) {
        return {
          content: [{
            type: 'text',
            text: '❌ Not connected to Telegram API. Please use telegram_api_login first.'
          }]
        };
      }
      
      try {
        const channelUrl = args.url || args.channel;
        const channelUsername = channelUrl.match(/(?:t\.me\/|@)([^/?]+)/)?.[1];
        
        if (!channelUsername) {
          return {
            content: [{
              type: 'text',
              text: '❌ Invalid channel URL or username'
            }]
          };
        }
        
        const client = (this._apiScraper as any).client;
        const info = await client.getChannelInfo(channelUsername);
        
        return {
          content: [{
            type: 'text',
            text: `# Channel Information
  
  **Name:** ${info.title}
  **Username:** @${info.username}
  **Type:** ${info.about}
  **Members:** ${info.participantsCount?.toLocaleString() || 'N/A'}
  **ID:** ${info.id}
  
  ✅ Retrieved using Telegram API`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: `❌ Failed to get channel info: ${error instanceof Error ? error.message : 'Unknown error'}`
          }]
        };
      }
    },

• src/server.ts:359-372 (registration)

  Registers the 'api_get_channel_info' tool with the MCP server, including its description and input schema requiring a 'url' parameter.

  {
    name: 'api_get_channel_info',
    description: 'Get detailed information about a Telegram channel using the API',
    inputSchema: {
      type: 'object',
      properties: {
        url: {
          type: 'string',
          description: 'The Telegram channel URL'
        }
      },
      required: ['url']
    }
  },

• src/server.ts:104-105 (registration)

  Switch case in the tool call handler that dispatches 'api_get_channel_info' calls to the bound handler method.

  case 'api_get_channel_info':
    return await this.handleApiGetChannelInfo(args);

• src/server.ts:766-766 (registration)

  Binds the handler function from apiHandlers to the server class instance for use in tool dispatching.

  private handleApiGetChannelInfo = apiHandlers.handleApiGetChannelInfo.bind(this);