telegram_api_login

Instructions

Implementation Reference

• src/server-api-handlers.ts:7-61 (handler)

  The handler function for 'telegram_api_login' that initializes TelegramApiScraper with API credentials (from args or env), performs login, stores the scraper instance, and returns success/error messages.

    async handleApiLogin(this: any, args: any): Promise<any> {
      try {
        // Get API credentials from environment or args
        const apiId = parseInt(process.env.TELEGRAM_API_ID || args.api_id || '0');
        const apiHash = process.env.TELEGRAM_API_HASH || args.api_hash || '';
        
        if (!apiId || !apiHash) {
          return {
            content: [{
              type: 'text',
              text: `❌ API credentials not provided.
  
  Please either:
  1. Set environment variables TELEGRAM_API_ID and TELEGRAM_API_HASH
  2. Pass api_id and api_hash as parameters
  3. See API_SETUP.md for instructions on getting your API credentials from https://my.telegram.org`
            }]
          };
        }
        
        const config: TelegramApiConfig = { apiId, apiHash };
        const scraper = new TelegramApiScraper(config);
        
        await scraper.initialize();
        
        // Store the scraper instance for reuse
        this._apiScraper = scraper;
        
        return {
          content: [{
            type: 'text',
            text: `✅ Successfully authenticated with Telegram API!
  
  You can now use the API-based tools:
  - api_scrape_channel - Fast channel scraping
  - api_search_channel - Search within channels
  - api_get_channel_info - Get channel details
  
  Your session has been saved for future use.`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: `❌ API authentication failed: ${error instanceof Error ? error.message : 'Unknown error'}
  
  Please check:
  - Your API credentials are correct
  - Your phone number includes country code (e.g., +1234567890)
  - You entered the verification code correctly`
          }]
        };
      }
    },

• src/server.ts:291-308 (schema)

  The MCP tool schema definition including name, description, and input schema for api_id and api_hash parameters.

  {
    name: 'telegram_api_login',
    description: 'Login to Telegram using API credentials for fast, efficient scraping',
    inputSchema: {
      type: 'object',
      properties: {
        api_id: {
          type: 'string',
          description: 'Your Telegram API ID (get from https://my.telegram.org)'
        },
        api_hash: {
          type: 'string',
          description: 'Your Telegram API Hash'
        }
      },
      required: []
    }
  },

• src/server.ts:95-96 (registration)

  The dispatch case in the tool call handler that routes 'telegram_api_login' calls to the handleApiLogin method.

  case 'telegram_api_login':
    return await this.handleApiLogin(args);

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

  The method binding that connects the server instance to the apiHandlers.handleApiLogin function.

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