instagram-mcp-server 1.0.0__tar.gz

instagram_mcp_server-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 official-Arvind
+
+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.

instagram_mcp_server-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include instagram_mcp_server *.py

instagram_mcp_server-1.0.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: instagram-mcp-server
+Version: 1.0.0
+Summary: MCP Server for full Instagram account control via AI agents — 68+ tools built with FastMCP + instagrapi
+Author-email: official-Arvind <stararvindgaming@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/official-Arvind/instagram-mcp
+Project-URL: Repository, https://github.com/official-Arvind/instagram-mcp
+Project-URL: Issues, https://github.com/official-Arvind/instagram-mcp/issues
+Keywords: instagram,mcp,model-context-protocol,ai,automation,fastmcp,instagrapi,claude,cursor,social-media
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=3.0.0
+Requires-Dist: instagrapi>=2.1.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: requests>=2.31.0
+Dynamic: license-file
+
+# 🤖 Instagram Control MCP Server
+
+> **Let any AI agent fully control a real Instagram account — post, DM, follow, comment, search, and more.**
+
+Built with **Python**, **[instagrapi](https://github.com/adw0rd/instagrapi)** (private mobile API), and **[FastMCP](https://github.com/jlowin/fastmcp)**.
+
+---
+
+## ✨ Features — 50+ Tools
+
+### 🔐 Authentication
+| Tool | Description |
+|------|-------------|
+| `instagram_login_with_sessionid` | Login via browser cookie (recommended) |
+| `instagram_login_with_credentials` | Login via username + password |
+| `instagram_complete_2fa` | Submit 2FA authenticator code |
+| `instagram_complete_challenge` | Submit email/SMS challenge code |
+| `instagram_get_login_status` | Check active session |
+| `instagram_logout` | Logout and clear session |
+
+### 👤 Profile
+| Tool | Description |
+|------|-------------|
+| `instagram_get_profile` | Get profile info (any user) |
+| `instagram_edit_profile` | Edit bio, name, website |
+| `instagram_change_profile_picture` | Change profile picture |
+
+### 📸 Feed Posting
+| Tool | Description |
+|------|-------------|
+| `instagram_post_photo` | Post a photo with caption + location |
+| `instagram_post_album` | Post carousel (up to 10 items) |
+| `instagram_post_video` | Post a feed video |
+| `instagram_post_reel` | Post a Reel |
+| `instagram_delete_post` | Delete a post permanently |
+| `instagram_get_user_feed` | Get posts from any user |
+| `instagram_get_timeline_feed` | Get your home feed |
+| `instagram_get_media_info` | Get details of any post |
+| `instagram_download_post` | Download photo/video to disk |
+
+### 📖 Stories
+| Tool | Description |
+|------|-------------|
+| `instagram_post_photo_story` | Post a photo story |
+| `instagram_post_video_story` | Post a video story |
+| `instagram_get_user_stories` | Get active stories (any user) |
+| `instagram_delete_story` | Delete your story |
+| `instagram_get_story_viewers` | See who viewed your story |
+
+### 🌟 Highlights
+| Tool | Description |
+|------|-------------|
+| `instagram_get_highlights` | Get highlights of any account |
+| `instagram_create_highlight` | Create a new highlight |
+| `instagram_delete_highlight` | Delete a highlight |
+
+### ❤️ Engagement
+| Tool | Description |
+|------|-------------|
+| `instagram_like_post` | Like a post |
+| `instagram_unlike_post` | Unlike a post |
+| `instagram_save_post` | Save a post |
+| `instagram_unsave_post` | Unsave a post |
+| `instagram_get_post_likers` | See who liked a post |
+| `instagram_comment_on_post` | Post a comment |
+| `instagram_reply_to_comment` | Reply to a comment |
+| `instagram_delete_comment` | Delete a comment |
+| `instagram_like_comment` | Like a comment |
+| `instagram_get_post_comments` | Get all comments on a post |
+
+### 👥 Following & Relations
+| Tool | Description |
+|------|-------------|
+| `instagram_follow_user` | Follow a user |
+| `instagram_unfollow_user` | Unfollow a user |
+| `instagram_get_followers` | Get followers list |
+| `instagram_get_following` | Get following list |
+| `instagram_block_user` | Block a user |
+| `instagram_unblock_user` | Unblock a user |
+| `instagram_get_blocked_users` | See blocked accounts |
+
+### 💬 Direct Messages
+| Tool | Description |
+|------|-------------|
+| `instagram_get_direct_threads` | Get DM thread list |
+| `instagram_get_direct_messages` | Get messages in a thread |
+| `instagram_send_direct_message` | Send text DM |
+| `instagram_send_dm_photo` | Send photo DM |
+| `instagram_send_dm_video` | Send video DM |
+| `instagram_mark_thread_seen` | Mark thread as read |
+
+### 🔍 Search & Explore
+| Tool | Description |
+|------|-------------|
+| `instagram_search_users` | Search users by name/username |
+| `instagram_search_hashtag` | Get recent posts by hashtag |
+| `instagram_get_hashtag_top_posts` | Get top posts by hashtag |
+| `instagram_get_hashtag_info` | Get hashtag stats |
+| `instagram_get_similar_accounts` | Find similar accounts |
+| `instagram_get_location_posts` | Get posts from a location |
+
+### 🔔 Notifications & Activity
+| Tool | Description |
+|------|-------------|
+| `instagram_get_notifications` | Get likes, comments, follows, mentions |
+| `instagram_get_pending_follow_requests` | Get pending follow requests |
+
+---
+
+## 🚀 Installation
+
+### 1. Clone this repository
+```bash
+git clone https://github.com/YOUR_USERNAME/instagram-mcp.git
+cd instagram-mcp
+```
+
+### 2. Create virtual environment & install dependencies
+```bash
+python -m venv venv
+
+# Windows
+venv\Scripts\pip install -r requirements.txt
+
+# Mac/Linux
+venv/bin/pip install -r requirements.txt
+```
+
+---
+
+## ⚙️ Integration with AI Clients
+
+### Claude Desktop
+Edit `%APPDATA%\Claude\claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "instagram-control": {
+      "command": "C:\\path\\to\\instagram-mcp\\venv\\Scripts\\python.exe",
+      "args": ["C:\\path\\to\\instagram-mcp\\mcp_server.py"]
+    }
+  }
+}
+```
+Restart Claude Desktop. The Instagram tools will appear automatically.
+
+### Cursor IDE
+1. Open **Settings** → **Features** → **MCP**
+2. Click **+ Add New MCP Server**
+3. Set:
+   - **Name:** `instagram-control`
+   - **Type:** `command`
+   - **Command:** `C:\path\to\instagram-mcp\venv\Scripts\python.exe C:\path\to\instagram-mcp\mcp_server.py`
+
+---
+
+## 🔐 Logging In
+
+### Method 1: Session ID (Recommended — No 2FA, Most Stable)
+1. Log in to Instagram in your browser (Chrome/Firefox/Edge)
+2. Open **DevTools** (F12) → **Application** (Chrome) or **Storage** (Firefox)
+3. Navigate to **Cookies** → `https://www.instagram.com`
+4. Find and copy the value of the `sessionid` cookie
+5. Tell your AI agent:
+   > `instagram_login_with_sessionid(username="your_username", session_id="YOUR_COOKIE_VALUE")`
+
+### Method 2: Username & Password
+```
+instagram_login_with_credentials(username="your_username", password="your_password")
+```
+- If 2FA is required: call `instagram_complete_2fa(code="123456")`
+- If a challenge triggers: call `instagram_complete_challenge(code="123456")`
+
+### Session Persistence
+After the first successful login, a `instagram_session.json` file is saved locally.
+On the next server start, the session is **automatically restored** — no re-authentication needed.
+
+---
+
+## ⚠️ Disclaimer
+This project uses Instagram's unofficial private API (`instagrapi`). Usage violates Instagram's Terms of Service. Use responsibly — do not spam, harass, or automate high-frequency actions. The authors are not responsible for any account suspension or ban resulting from use of this software.
+
+---
+
+## 🛠️ Tech Stack
+- **[FastMCP](https://github.com/jlowin/fastmcp)** — MCP server framework
+- **[instagrapi](https://github.com/adw0rd/instagrapi)** — Instagram private API wrapper
+- **[Pillow](https://pillow.readthedocs.io/)** — Image processing
+- **[Requests](https://requests.readthedocs.io/)** — HTTP downloads
+
+---
+
+## 📄 License
+MIT License — free to use, modify, and distribute.

instagram_mcp_server-1.0.0/README.md

@@ -0,0 +1,194 @@
+# 🤖 Instagram Control MCP Server
+
+> **Let any AI agent fully control a real Instagram account — post, DM, follow, comment, search, and more.**
+
+Built with **Python**, **[instagrapi](https://github.com/adw0rd/instagrapi)** (private mobile API), and **[FastMCP](https://github.com/jlowin/fastmcp)**.
+
+---
+
+## ✨ Features — 50+ Tools
+
+### 🔐 Authentication
+| Tool | Description |
+|------|-------------|
+| `instagram_login_with_sessionid` | Login via browser cookie (recommended) |
+| `instagram_login_with_credentials` | Login via username + password |
+| `instagram_complete_2fa` | Submit 2FA authenticator code |
+| `instagram_complete_challenge` | Submit email/SMS challenge code |
+| `instagram_get_login_status` | Check active session |
+| `instagram_logout` | Logout and clear session |
+
+### 👤 Profile
+| Tool | Description |
+|------|-------------|
+| `instagram_get_profile` | Get profile info (any user) |
+| `instagram_edit_profile` | Edit bio, name, website |
+| `instagram_change_profile_picture` | Change profile picture |
+
+### 📸 Feed Posting
+| Tool | Description |
+|------|-------------|
+| `instagram_post_photo` | Post a photo with caption + location |
+| `instagram_post_album` | Post carousel (up to 10 items) |
+| `instagram_post_video` | Post a feed video |
+| `instagram_post_reel` | Post a Reel |
+| `instagram_delete_post` | Delete a post permanently |
+| `instagram_get_user_feed` | Get posts from any user |
+| `instagram_get_timeline_feed` | Get your home feed |
+| `instagram_get_media_info` | Get details of any post |
+| `instagram_download_post` | Download photo/video to disk |
+
+### 📖 Stories
+| Tool | Description |
+|------|-------------|
+| `instagram_post_photo_story` | Post a photo story |
+| `instagram_post_video_story` | Post a video story |
+| `instagram_get_user_stories` | Get active stories (any user) |
+| `instagram_delete_story` | Delete your story |
+| `instagram_get_story_viewers` | See who viewed your story |
+
+### 🌟 Highlights
+| Tool | Description |
+|------|-------------|
+| `instagram_get_highlights` | Get highlights of any account |
+| `instagram_create_highlight` | Create a new highlight |
+| `instagram_delete_highlight` | Delete a highlight |
+
+### ❤️ Engagement
+| Tool | Description |
+|------|-------------|
+| `instagram_like_post` | Like a post |
+| `instagram_unlike_post` | Unlike a post |
+| `instagram_save_post` | Save a post |
+| `instagram_unsave_post` | Unsave a post |
+| `instagram_get_post_likers` | See who liked a post |
+| `instagram_comment_on_post` | Post a comment |
+| `instagram_reply_to_comment` | Reply to a comment |
+| `instagram_delete_comment` | Delete a comment |
+| `instagram_like_comment` | Like a comment |
+| `instagram_get_post_comments` | Get all comments on a post |
+
+### 👥 Following & Relations
+| Tool | Description |
+|------|-------------|
+| `instagram_follow_user` | Follow a user |
+| `instagram_unfollow_user` | Unfollow a user |
+| `instagram_get_followers` | Get followers list |
+| `instagram_get_following` | Get following list |
+| `instagram_block_user` | Block a user |
+| `instagram_unblock_user` | Unblock a user |
+| `instagram_get_blocked_users` | See blocked accounts |
+
+### 💬 Direct Messages
+| Tool | Description |
+|------|-------------|
+| `instagram_get_direct_threads` | Get DM thread list |
+| `instagram_get_direct_messages` | Get messages in a thread |
+| `instagram_send_direct_message` | Send text DM |
+| `instagram_send_dm_photo` | Send photo DM |
+| `instagram_send_dm_video` | Send video DM |
+| `instagram_mark_thread_seen` | Mark thread as read |
+
+### 🔍 Search & Explore
+| Tool | Description |
+|------|-------------|
+| `instagram_search_users` | Search users by name/username |
+| `instagram_search_hashtag` | Get recent posts by hashtag |
+| `instagram_get_hashtag_top_posts` | Get top posts by hashtag |
+| `instagram_get_hashtag_info` | Get hashtag stats |
+| `instagram_get_similar_accounts` | Find similar accounts |
+| `instagram_get_location_posts` | Get posts from a location |
+
+### 🔔 Notifications & Activity
+| Tool | Description |
+|------|-------------|
+| `instagram_get_notifications` | Get likes, comments, follows, mentions |
+| `instagram_get_pending_follow_requests` | Get pending follow requests |
+
+---
+
+## 🚀 Installation
+
+### 1. Clone this repository
+```bash
+git clone https://github.com/YOUR_USERNAME/instagram-mcp.git
+cd instagram-mcp
+```
+
+### 2. Create virtual environment & install dependencies
+```bash
+python -m venv venv
+
+# Windows
+venv\Scripts\pip install -r requirements.txt
+
+# Mac/Linux
+venv/bin/pip install -r requirements.txt
+```
+
+---
+
+## ⚙️ Integration with AI Clients
+
+### Claude Desktop
+Edit `%APPDATA%\Claude\claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "instagram-control": {
+      "command": "C:\\path\\to\\instagram-mcp\\venv\\Scripts\\python.exe",
+      "args": ["C:\\path\\to\\instagram-mcp\\mcp_server.py"]
+    }
+  }
+}
+```
+Restart Claude Desktop. The Instagram tools will appear automatically.
+
+### Cursor IDE
+1. Open **Settings** → **Features** → **MCP**
+2. Click **+ Add New MCP Server**
+3. Set:
+   - **Name:** `instagram-control`
+   - **Type:** `command`
+   - **Command:** `C:\path\to\instagram-mcp\venv\Scripts\python.exe C:\path\to\instagram-mcp\mcp_server.py`
+
+---
+
+## 🔐 Logging In
+
+### Method 1: Session ID (Recommended — No 2FA, Most Stable)
+1. Log in to Instagram in your browser (Chrome/Firefox/Edge)
+2. Open **DevTools** (F12) → **Application** (Chrome) or **Storage** (Firefox)
+3. Navigate to **Cookies** → `https://www.instagram.com`
+4. Find and copy the value of the `sessionid` cookie
+5. Tell your AI agent:
+   > `instagram_login_with_sessionid(username="your_username", session_id="YOUR_COOKIE_VALUE")`
+
+### Method 2: Username & Password
+```
+instagram_login_with_credentials(username="your_username", password="your_password")
+```
+- If 2FA is required: call `instagram_complete_2fa(code="123456")`
+- If a challenge triggers: call `instagram_complete_challenge(code="123456")`
+
+### Session Persistence
+After the first successful login, a `instagram_session.json` file is saved locally.
+On the next server start, the session is **automatically restored** — no re-authentication needed.
+
+---
+
+## ⚠️ Disclaimer
+This project uses Instagram's unofficial private API (`instagrapi`). Usage violates Instagram's Terms of Service. Use responsibly — do not spam, harass, or automate high-frequency actions. The authors are not responsible for any account suspension or ban resulting from use of this software.
+
+---
+
+## 🛠️ Tech Stack
+- **[FastMCP](https://github.com/jlowin/fastmcp)** — MCP server framework
+- **[instagrapi](https://github.com/adw0rd/instagrapi)** — Instagram private API wrapper
+- **[Pillow](https://pillow.readthedocs.io/)** — Image processing
+- **[Requests](https://requests.readthedocs.io/)** — HTTP downloads
+
+---
+
+## 📄 License
+MIT License — free to use, modify, and distribute.

instagram_mcp_server-1.0.0/instagram_mcp_server/__init__.py

@@ -0,0 +1,9 @@
+"""
+instagram_mcp_server — Instagram Control MCP Server
+A FastMCP + instagrapi powered server exposing 68+ tools for full
+Instagram account control via any MCP-compatible AI agent.
+"""
+
+__version__ = "1.0.0"
+__author__ = "official-Arvind"
+__email__ = "stararvindgaming@gmail.com"

instagram_mcp_server-1.0.0/instagram_mcp_server/__main__.py

@@ -0,0 +1,20 @@
+"""
+Entry point for running the Instagram MCP server as a CLI command.
+Usage: instagram-mcp
+"""
+import os
+import sys
+
+
+def main():
+    # Ensure the package directory is in sys.path when called as CLI
+    pkg_dir = os.path.dirname(os.path.abspath(__file__))
+    if pkg_dir not in sys.path:
+        sys.path.insert(0, pkg_dir)
+
+    from instagram_mcp_server.mcp_server import mcp
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

instagram_mcp_server-1.0.0/instagram_mcp_server/instagram_client.py

@@ -0,0 +1,183 @@
+"""
+instagram_client.py
+--------------------
+Core Instagram client wrapper built on top of instagrapi.
+Handles authentication, session persistence, 2FA/challenge flows,
+and exposes a clean API for mcp_server.py to consume.
+"""
+
+import os
+import sys
+import logging
+from typing import Optional, Dict, Any
+
+from instagrapi import Client
+from instagrapi.exceptions import (
+    TwoFactorRequired,
+    ChallengeRequired,
+    LoginRequired,
+    UserNotFound,
+    MediaNotFound,
+    RateLimitError,
+    BadPassword,
+)
+
+# Log to stderr only — never stdout (would corrupt stdio MCP transport)
+logging.basicConfig(stream=sys.stderr, level=logging.INFO,
+                    format="[instagram_client] %(levelname)s: %(message)s")
+logger = logging.getLogger("instagram_client")
+
+
+class InstagramClientWrapper:
+    def __init__(self, session_path: str = "instagram_session.json"):
+        self.cl = Client()
+        self.cl.delay_range = [1, 3]  # human-like delays between requests
+        self.session_path = session_path
+        self.username: Optional[str] = None
+        self.password: Optional[str] = None
+        self.pending_2fa: bool = False
+        self.pending_challenge: bool = False
+
+    # ------------------------------------------------------------------
+    # SESSION MANAGEMENT
+    # ------------------------------------------------------------------
+
+    def load_session(self) -> bool:
+        """Attempts to load a saved session from disk."""
+        if os.path.exists(self.session_path):
+            try:
+                logger.info(f"Loading session from {self.session_path}")
+                self.cl.load_settings(self.session_path)
+                return True
+            except Exception as e:
+                logger.error(f"Failed to load session: {e}")
+                try:
+                    os.remove(self.session_path)
+                except Exception:
+                    pass
+        return False
+
+    def save_session(self):
+        """Saves the current session to disk."""
+        try:
+            self.cl.dump_settings(self.session_path)
+            logger.info(f"Session saved to {self.session_path}")
+        except Exception as e:
+            logger.error(f"Failed to save session: {e}")
+
+    def is_logged_in(self) -> bool:
+        """Probes Instagram to verify the current session is valid."""
+        try:
+            if self.cl.user_id:
+                self.cl.get_timeline_feed()
+                return True
+        except Exception:
+            pass
+        return False
+
+    def init_from_saved_session(self) -> Dict[str, Any]:
+        """Try restoring an existing session on startup."""
+        if self.load_session():
+            if self.is_logged_in():
+                self.username = self.cl.username
+                return {"status": "success", "message": f"Auto-restored session for @{self.username}"}
+        return {"status": "not_logged_in", "message": "No valid saved session found."}
+
+    # ------------------------------------------------------------------
+    # LOGIN METHODS
+    # ------------------------------------------------------------------
+
+    def login_with_credentials(self, username: str, password: str,
+                                verification_code: Optional[str] = None) -> Dict[str, Any]:
+        """Login using username + password, with optional 2FA code."""
+        self.username = username
+        self.password = password
+        self.pending_2fa = False
+        self.pending_challenge = False
+
+        def challenge_code_handler(uname, choice):
+            logger.warning(f"Challenge triggered for {uname} via {choice}")
+            self.pending_challenge = True
+            raise ChallengeRequired("Challenge code required.")
+
+        self.cl.challenge_code_handler = challenge_code_handler
+
+        try:
+            logger.info(f"Logging in as {username}...")
+            if verification_code:
+                self.cl.login(username, password, verification_code=verification_code)
+            else:
+                self.cl.login(username, password)
+
+            self.save_session()
+            return {"status": "success", "message": f"Logged in as @{username}"}
+
+        except TwoFactorRequired:
+            self.pending_2fa = True
+            return {
+                "status": "needs_2fa",
+                "message": "2FA required. Call instagram_complete_2fa with the code from your authenticator app."
+            }
+        except ChallengeRequired:
+            self.pending_challenge = True
+            return {
+                "status": "needs_challenge",
+                "message": "Security challenge triggered. Call instagram_complete_challenge with the code sent to your email/SMS."
+            }
+        except BadPassword:
+            return {"status": "error", "message": "Incorrect password."}
+        except Exception as e:
+            logger.error(f"Login error: {e}")
+            return {"status": "error", "message": str(e)}
+
+    def login_with_sessionid(self, username: str, session_id: str) -> Dict[str, Any]:
+        """Login using a browser sessionid cookie — most stable method."""
+        self.username = username
+        self.pending_2fa = False
+        self.pending_challenge = False
+
+        try:
+            logger.info(f"Logging in via session ID for @{username}...")
+            self.cl.login_by_sessionid(session_id)
+
+            if self.is_logged_in():
+                self.username = self.cl.username
+                self.save_session()
+                return {"status": "success", "message": f"Authenticated as @{self.username} via session ID."}
+            else:
+                return {"status": "error", "message": "Session ID login verification failed. The session may be expired."}
+        except Exception as e:
+            logger.error(f"Session ID login error: {e}")
+            return {"status": "error", "message": str(e)}
+
+    def complete_2fa(self, code: str) -> Dict[str, Any]:
+        """Completes a pending 2FA login."""
+        if not self.username or not self.password:
+            return {"status": "error", "message": "No pending login. Call login_with_credentials first."}
+        return self.login_with_credentials(self.username, self.password, verification_code=code)
+
+    def complete_challenge(self, code: str) -> Dict[str, Any]:
+        """Completes a pending security challenge."""
+        if not self.username or not self.password:
+            return {"status": "error", "message": "No pending login. Call login_with_credentials first."}
+        return self.login_with_credentials(self.username, self.password, verification_code=code)
+
+    def logout(self) -> Dict[str, Any]:
+        """Logs out and removes saved session."""
+        try:
+            self.cl.logout()
+            if os.path.exists(self.session_path):
+                os.remove(self.session_path)
+            self.username = None
+            self.password = None
+            return {"status": "success", "message": "Logged out and session cleared."}
+        except Exception as e:
+            return {"status": "error", "message": str(e)}
+
+    def get_login_status(self) -> Dict[str, Any]:
+        logged = self.is_logged_in()
+        return {
+            "logged_in": logged,
+            "username": (self.cl.username if logged else None),
+            "user_id": (str(self.cl.user_id) if logged else None)
+        }