Insta MCP Server

Instructions

Implementation Reference

• src/tools/login.ts:24-103 (handler)

  The 'execute' method in LoginTool class implements the core logic of the 'instagram_login' tool. It retrieves credentials from config, checks for existing session, performs login using igpapiClient, handles success response, and manages 2FA requirement by instructing to use complete_2fa tool.

  async execute(args: Record<string, unknown>): Promise<ToolResult> {
    // Get credentials from environment variables via config
    const config = getConfig();
    const username = config.igpapi?.username;
    const password = config.igpapi?.password;
  
    // Validate that credentials are available
    if (!username || !password) {
      throw new Error(
        "Instagram credentials not found in environment variables. " +
        "Please set IG_USERNAME and IG_PASSWORD environment variables."
      );
    }
  
    // Check if already logged in
    if (igpapiClient.isLoggedIn()) {
      try {
        const currentUser = await igpapiClient.getCurrentUser();
        return {
          content: [
            {
              type: "text",
              text: `Already logged in as: ${currentUser.username || username}\nSession is active and persistent.`,
            },
          ],
        };
      } catch {
        // Session might be invalid, continue with login
      }
    }
  
    // Initialize client if needed
    if (!igpapiClient.isInitialized()) {
      await igpapiClient.initialize();
    }
  
    try {
      // Perform login
      await igpapiClient.login(username, password);
  
      // Get user info to confirm login
      const user = await igpapiClient.getCurrentUser();
  
      return {
        content: [
          {
            type: "text",
            text: `Successfully logged in to Instagram!\n\nAccount: ${user.username}\nFull Name: ${user.full_name || "N/A"}\nUser ID: ${user.pk}\n\nSession has been saved and will persist across server restarts.`,
          },
        ],
      };
    } catch (error) {
      // Check if this is a 2FA requirement
      if (error && typeof error === "object" && "verificationMethod" in error) {
        const twoFactorInfo = error as {
          username: string;
          verificationMethod: "0" | "1";
          totpTwoFactorOn: boolean;
        };
  
        const methodName = twoFactorInfo.verificationMethod === "1" ? "SMS" : "TOTP (Authenticator App)";
        const codeSentMessage = twoFactorInfo.verificationMethod === "1" 
          ? "A verification code has been sent to your phone via SMS."
          : "Please check your authenticator app for the verification code.";
  
        return {
          content: [
            {
              type: "text",
              text: `Two-Factor Authentication (2FA) is required for this account.\n\n${codeSentMessage}\n\nVerification Method: ${methodName}\nUsername: ${twoFactorInfo.username}\n\nPlease use the 'instagram_complete_2fa' tool with the verification code to complete the login.`,
            },
          ],
          isError: false, // Not an error, just requires additional step
        };
      }
  
      // Re-throw other errors
      throw error;
    }
  }

• src/tools/login.ts:11-22 (schema)

  The 'getDefinition' method defines the tool schema for 'instagram_login', specifying its name, description, and empty input schema (no parameters required).

  export class LoginTool extends BaseTool {
    getDefinition(): ToolDefinition {
      return {
        name: "instagram_login",
        description: "Login to an Instagram account using credentials from environment variables (IG_USERNAME and IG_PASSWORD). The session will be saved and persist across server restarts.",
        inputSchema: {
          type: "object",
          properties: {},
          required: [],
        },
      };
    }

• src/tools/index.ts:25-42 (registration)

  The 'instagram_login' tool (LoginTool) is registered by instantiating LoginTool and adding it to the tools array, which is used by getAllToolDefinitions() for MCP server registration.

  const tools: BaseTool[] = [
    new LoginTool(),
    new Complete2FATool(),
    new SearchAccountsTool(),
    new LogoutTool(),
    new GetUserProfileTool(),
    new GetCurrentUserProfileTool(),
    new GetUserPostsTool(),
    new LikePostTool(),
    new LikeCommentTool(),
    new CommentOnPostTool(),
    new GetPostCommentsTool(),
    new GetPostDetailsTool(),
    new GetUserStoriesTool(),
    new GetTimelineFeedTool(),
    new FollowUserTool(),
    // Add more tools here as you create them
  ];

• src/tools/index.ts:7-7 (registration)

  Import statement for LoginTool used in tool registration.

  import { LoginTool } from "./login.js";