Instagram Clone MCP Tools Reference

Auth Tools (4)

auth_sign_up

Parameter	Type	Required	Description
`email`	string (email)	✅	User email
`password`	string	✅	Password (min 8 characters)
`name`	string	✅	Display name
`username`	string	✅	Unique username

{
  "email": "user@example.com",
  "password": "12345678",
  "name": "Test User",
  "username": "testuser"
}

auth_sign_in

Parameter	Type	Required	Description
`email`	string (email)	✅	User email
`password`	string	✅	Password

{
  "email": "user@example.com",
  "password": "12345678"
}

auth_sign_out

Sign out and clear session.

auth_get_session

Get current session info.

User Tools (11)

get_user_profile

Get user profile by user ID or username.

Parameter	Type	Required	Description
`identifier`	string	✅	User ID or username

{
  "identifier": "black444"
}

get_current_user

Get current user’s own profile.

search_users

Search users by username or bio.

Parameter	Type	Required	Description
`query`	string	✅	Search query
`limit`	number	❌	Maximum results (default: 20)

{
  "query": "black",
  "limit": 10
}

get_suggested_users

Get suggested users to follow.

Parameter	Type	Required	Description
`limit`	number	❌	Maximum results (default: 10)

{
  "limit": 5
}

toggle_follow_user

Follow or unfollow a user. Checks current follow status first to prevent accidental follow/unfollow.

Parameter	Type	Required	Description
`targetIdentifier`	string	✅	Target user ID or username
`action`	enum	✅	`"follow"` or `"unfollow"`

{
  "targetIdentifier": "black444",
  "action": "follow"
}

block_user

Block a user.

Parameter	Type	Required	Description
`targetIdentifier`	string	✅	Target user ID or username to block

{
  "targetIdentifier": "black555"
}

unblock_user

Unblock a user.

Parameter	Type	Required	Description
`targetIdentifier`	string	✅	Target user ID or username to unblock

{
  "targetIdentifier": "black555"
}

get_user_followers

Get a user’s followers list.

Parameter	Type	Required	Description
`identifier`	string	✅	User ID or username

{
  "identifier": "black444"
}

get_user_following

Get a user’s following list.

Parameter	Type	Required	Description
`identifier`	string	✅	User ID or username

{
  "identifier": "black444"
}

is_following

Check if current user is following a specific user.

Parameter	Type	Required	Description
`identifier`	string	✅	Target user ID or username

{
  "identifier": "black444"
}

get_blocked_users

Get current user’s blocked users list.

Post Tools (11)

create_post

Create a new post.

Parameter	Type	Required	Description
`image`	string[]	✅	Array of image URLs
`caption`	string	❌	Post caption

{
  "image": ["https://example.com/photo.jpg"],
  "caption": "Hello world!"
}

delete_post

Delete a post.

Parameter	Type	Required	Description
`postId`	string	✅	Post ID to delete

{
  "postId": "abc123"
}

edit_post

Edit a post’s caption or images.

Parameter	Type	Required	Description
`postId`	string	✅	Post ID to edit
`caption`	string	❌	New caption
`image`	string[]	❌	New array of image URLs

{
  "postId": "abc123",
  "caption": "Updated caption"
}

toggle_like_post

Like or unlike a post.

Parameter	Type	Required	Description
`postId`	string	✅	Post ID

{
  "postId": "abc123"
}

toggle_bookmark_post

Bookmark or unbookmark a post.

Parameter	Type	Required	Description
`postId`	string	✅	Post ID

{
  "postId": "abc123"
}

get_user_posts

Get posts by a specific user.

Parameter	Type	Required	Description
`username`	string	✅	Username
`limit`	number	❌	Maximum posts (default: 10)
`lastCreatedAt`	string	❌	Pagination cursor (ISO date)

{
  "username": "black444",
  "limit": 5
}

get_feed_posts

Get feed posts from followed users.

Parameter	Type	Required	Description
`page`	number	❌	Page number (default: 1)
`limit`	number	❌	Posts per page (default: 10)

{
  "page": 1,
  "limit": 10
}

get_explore_posts

Get explore/discover posts.

Parameter	Type	Required	Description
`limit`	number	❌	Maximum posts (default: 10)
`lastCreatedAt`	string	❌	Pagination cursor

{
  "limit": 10
}

search_posts

Search posts by caption.

Parameter	Type	Required	Description
`query`	string	✅	Search query
`limit`	number	❌	Maximum results (default: 20)

{
  "query": "sunset",
  "limit": 10
}

get_bookmarked_posts

Get user’s bookmarked posts.

get_post_likes

Get list of users who liked a post.

Parameter	Type	Required	Description
`postId`	string	✅	Post ID

{
  "postId": "abc123"
}

Comment Tools (5)

create_comment

Create a comment on a post (or reply to a comment if commentId provided).

Parameter	Type	Required	Description
`postId`	string	✅	Post ID
`text`	string	✅	Comment text
`commentId`	string	❌	Parent comment ID (for replies)

{
  "postId": "abc123",
  "text": "Great post! 👍"
}

Reply example:

{
  "postId": "abc123",
  "text": "Thanks!",
  "commentId": "comment456"
}

delete_comment

Delete a comment or reply.

Parameter	Type	Required	Description
`commentId`	string	✅	Comment ID to delete

{
  "commentId": "comment456"
}

get_post_comments

Get comments for a post (top-level only).

Parameter	Type	Required	Description
`postId`	string	✅	Post ID

{
  "postId": "abc123"
}

get_comment_replies

Get replies for a comment.

Parameter	Type	Required	Description
`commentId`	string	✅	Parent comment ID
`limit`	number	❌	Maximum replies (default: 10)

{
  "commentId": "comment456",
  "limit": 5
}

delete_reply

Delete a reply (second-level comment).

Parameter	Type	Required	Description
`replyId`	string	✅	Reply ID to delete

{
  "replyId": "reply789"
}

Notification Tools (2)

get_notifications

Get user’s notifications.

mark_notifications_read

Mark all notifications as read.

Message Tools (2)

get_chats

Get user’s chat list.

get_chat_messages

Get messages with another user.

Parameter	Type	Required	Description
`partnerIdentifier`	string	✅	Partner user ID or username

{
  "partnerIdentifier": "black444"
}

Profile Tools (3)

edit_profile

Update user profile information.

Parameter	Type	Required	Description
`name`	string	❌	New display name
`username`	string	❌	New username
`bio`	string	❌	New bio
`gender`	string	❌	Gender
`image`	string (url)	❌	Avatar image URL

{
  "bio": "Hello World 🚀",
  "gender": "male",
  "image": "https://example.com/avatar.jpg"
}

change_password

Change user password.

Parameter	Type	Required	Description
`currentPassword`	string	✅	Current password
`newPassword`	string	✅	New password (min 8 characters)

{
  "currentPassword": "12345678",
  "newPassword": "newpassword123"
}

delete_account

Request account deletion (sends verification email).

Socket Tools (4)

send_message

Send a direct message to another user (via Socket.IO).

Parameter	Type	Required	Description
`receiverId`	string	✅	Receiver user ID
`content`	string	✅	Message content

{
  "receiverId": "698a85ca82d10455f2a3e590",
  "content": "Hello! 👋"
}

get_online_users

Get list of currently online users.

check_user_online

Check if a specific user is online.

Parameter	Type	Required	Description
`targetUserId`	string	✅	User ID to check

{
  "targetUserId": "698a85ca82d10455f2a3e590"
}

MCP Server

Tools

​Instagram Clone MCP Tools Reference

​Auth Tools (4)

​auth_sign_up

​auth_sign_in

​auth_sign_out

​auth_get_session

​User Tools (11)

​get_user_profile

​get_current_user

​search_users

​get_suggested_users

​toggle_follow_user

​block_user

​unblock_user

​get_user_followers

​get_user_following

​is_following

​get_blocked_users

​Post Tools (11)

​create_post

​delete_post

​edit_post

​toggle_like_post

​toggle_bookmark_post

​get_user_posts

​get_feed_posts

​get_explore_posts

​search_posts

​get_bookmarked_posts

​get_post_likes

​Comment Tools (5)

​create_comment

​delete_comment

​get_post_comments

​get_comment_replies

​delete_reply

​Notification Tools (2)

​get_notifications

​mark_notifications_read

​Message Tools (2)

​get_chats

​get_chat_messages

​Profile Tools (3)

​edit_profile

​change_password

​delete_account

​Socket Tools (4)

​send_message

​get_online_users

​check_user_online