Connection check
verified live · 27h ago
mcp-dir-instagram-mcp
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Tools
33
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
27h ago
Tools & capabilities
33 toolsRead from the running server on 27h ago.
authenticate
token
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent… MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
connect
read-only
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the tool… Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
instagram_actions_follow
accounttargets*
Follow one or more Instagram users by @username. Returns a job_id. Follow one or more Instagram users by @username. Returns a job_id.
instagram_actions_get_job_status
read-only
job_id*accountjob_ids
Get the status/progress/result of a previously started action by its job_id. Bulk support: accepts job_ids for batched execution. Get the status/progress/result of a previously started action by its job_id. Bulk support: accepts job_ids for batched execution.
instagram_actions_like
posts*account
Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). Returns a job_id; poll instagram_actions_get_job_status. Like one or more Instagram posts, addressed by post URL or shortcode (NOT the numeric media id the official API returns). Returns a job_id; poll instagram_actions_get_job_status.
instagram_actions_like_comment
accountcomment_ids*
Like one or more comments. Each comment_id MUST come from instagram_actions_list_comments. The id returned by the official instagram_get_ig_media_comments belongs to a different na… Like one or more comments. Each comment_id MUST come from instagram_actions_list_comments. The id returned by the official instagram_get_ig_media_comments belongs to a different namespace and is rejected. Returns a job_id; poll instagram_actions_get_job_status.
instagram_actions_list_accounts
read-only
account
List the Instagram accounts connected to this install — id, username, label. List the Instagram accounts connected to this install — id, username, label.
instagram_actions_list_comments
read-only
posts*account
List the comments on a post, addressed by URL or shortcode. Returns each comment_id in the form that instagram_actions_like_comment accepts. The official API returns a DIFFERENT id… List the comments on a post, addressed by URL or shortcode. Returns each comment_id in the form that instagram_actions_like_comment accepts. The official API returns a DIFFERENT id that is not accepted there. Returns a job_id; poll instagram_actions_get_job_status.
instagram_actions_list_jobs
read-only
statusaccount
List recent action jobs for the connected account, optionally filtered by status. List recent action jobs for the connected account, optionally filtered by status.
instagram_actions_list_stories
read-only
waittarget*account
List a specific user's currently available stories (read-only, does not mark as seen). Returns a job_id (or the result inline when wait=true). List a specific user's currently available stories (read-only, does not mark as seen). Returns a job_id (or the result inline when wait=true).
instagram_actions_send_message
text*target*accountdry_run
Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). One recipient per call, low daily cap. Returns a job_id. Send the FIRST direct message to someone who has never messaged this account (the official API cannot do this). One recipient per call, low daily cap. Returns a job_id.
instagram_actions_unfollow
accounttargets*
Unfollow one or more Instagram users by @username. Returns a job_id. Unfollow one or more Instagram users by @username. Returns a job_id.
instagram_actions_view_story
accounttargets
Watch (mark as seen) the stories of one or more profiles. Omit `targets` to watch the home tray. Returns a job_id. Watch (mark as seen) the stories of one or more profiles. Omit `targets` to watch the home tray. Returns a job_id.
instagram_create_carousel_container
accountcaptionchildrenig_user_idig_user_idslocation_id
+7
Create a draft carousel post with multiple images/videos before publishing. Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in unde… Create a draft carousel post with multiple images/videos before publishing. Instagram requires carousels to have between 2 and 10 media items. Container creation_ids expire in under 24 hours, so publish promptly after creation. Bulk support: accepts ig_user_ids, location_ids for batched execution.
instagram_get_conversation
read-only
accountconversation_id*conversation_idsgraph_api_version
Get details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will retu… Get details about a specific Instagram DM conversation (participants, etc). Requires a Business or Creator account with Instagram messaging permissions; personal accounts will return permission errors. Newly sent/received messages may take a few seconds to appear in results. Bulk support: accepts conversation_ids for batched execution.
instagram_get_ig_media
read-only
fieldsaccountig_media_id*ig_media_idsgraph_api_version
Get a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engage… Get a published Instagram Media object (photo, video, story, reel, or carousel). Use when you need to retrieve detailed information about a specific Instagram post including engagement metrics, caption, media URLs, and metadata. NOTE: This action is for published media only. For unpublished container IDs (from INSTAGR… Bulk support: accepts ig_media_ids for batched execution.
instagram_get_ig_media_comments
read-only
afterlimitbeforefieldsaccountig_media_id*
+2
Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Busines… Tool to retrieve comments on an Instagram media object. Use when you need to fetch comments from a specific Instagram post, photo, video, or carousel owned by the connected Business/Creator account. Supports cursor-based pagination for navigating through large comment lists. An empty data array in the response indicat… Bulk support: accepts ig_media_ids for batched execution.
instagram_get_ig_media_insights
read-only
metric*periodaccountbreakdownig_media_id*ig_media_ids
+1
Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). Use when you need to retrieve performance data such as views, reach, likes, c… Tool to get insights and metrics for Instagram media objects (photos, videos, reels, carousel albums). Use when you need to retrieve performance data such as views, reach, likes, comments, saves, and shares for specific media. Note: Insights data is only available for media published within the last 2 years, and the a… Bulk support: accepts ig_media_ids for batched execution.
instagram_get_ig_user_media
read-only
afterlimitsinceuntilbeforefields
+6
Get Instagram user's media collection (posts, photos, videos, reels, carousels). Use when you need to retrieve all media published by an Instagram Business or Creator account with… Get Instagram user's media collection (posts, photos, videos, reels, carousels). Use when you need to retrieve all media published by an Instagram Business or Creator account with support for pagination and time-based filtering. Bulk support: accepts ig_user_ids, auto_resolve_fb_page_ids for batched execution.
instagram_get_user_info
read-only
accountig_user_idig_user_idsgraph_api_version
Get Instagram Business Account info including profile details and statistics. Use "me" to query your own authenticated account, or provide the numeric Business Account ID of an acc… Get Instagram Business Account info including profile details and statistics. Use "me" to query your own authenticated account, or provide the numeric Business Account ID of an account you manage. NOTE: followers_count and follows_count are returned for your own profile (ig_user_id="me"). For other accounts, follower/… Bulk support: accepts ig_user_ids for batched execution.
instagram_get_user_insights
read-only
sinceuntilmetricperiodaccountbreakdown
+5
Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). Requires a Business or Creator account; personal accounts are not supported. Return… Get Instagram account-level insights and analytics (profile views, reach, follower count, etc.). Requires a Business or Creator account; personal accounts are not supported. Returned timestamps are in UTC. metric_type (time_series or total_value): When set to total_value, the API returns a total_value object instead o… Bulk support: accepts ig_user_ids for batched execution.
instagram_list_all_conversations
read-only
afterlimitaccountuser_idplatformuser_ids
+3
List all Instagram DM conversations for the authenticated user. Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response con… List all Instagram DM conversations for the authenticated user. Requires a Business/Creator account with messaging permissions; personal accounts return empty results. Response conversations are nested under `data.data` — accessing top-level `data` as the final list returns zero items. An empty `data` list is a valid … Bulk support: accepts user_ids, ig_user_ids for batched execution.
instagram_list_all_messages
read-only
afterlimitaccountconversation_id*conversation_idsgraph_api_version
List all messages from a specific Instagram DM conversation. Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response dat… List all messages from a specific Instagram DM conversation. Requires a Business or Creator account with messaging permissions; personal accounts return empty results. Response data is nested under data.data (double-wrapped); attachment-only messages may have empty text fields. Bulk support: accepts conversation_ids for batched execution.
instagram_mark_seen
accountig_user_idig_user_idsrecipient_id*recipient_idsgraph_api_version
Mark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is… Mark Instagram DM messages as read/seen for a specific user. Sends a 'mark_seen' sender action to indicate messages from the specified recipient have been read. Marking as seen is visible to the other party and changes inbox read state — use with explicit user approval in automated or bulk flows. IMPORTANT LIMITATIONS… Bulk support: accepts ig_user_ids, recipient_ids for batched execution.
instagram_post_ig_comment_replies
accountmessage*ig_comment_id*ig_comment_idsgraph_api_version
Tool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300… Tool to create a reply to an Instagram comment. Use when you need to reply to a specific comment on an Instagram post owned by a Business or Creator account. The reply must be 300 characters or less, contain at most 4 hashtags and 1 URL, and cannot consist entirely of capital letters. Bulk support: accepts ig_comment_ids for batched execution.
instagram_post_ig_user_media
accountcaptionalt_textchildrencover_urlimage_url
+14
Tool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publish… Tool to create a media container for Instagram posts. Use this to create a container for images, videos, Reels, or carousels. This is the first step in Instagram's two-step publishing process - after creating the container, use the media_publish endpoint to publish it. Bulk support: accepts ig_user_ids, location_ids for batched execution.
instagram_post_ig_user_media_publish
accountig_user_idcreation_id*ig_user_idscreation_idsmax_wait_seconds
+2
Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Instagram enforces an… Tool to publish a media container to an Instagram Business account. This action automatically waits for the container to finish processing before publishing. Instagram enforces an account-specific content-publishing rate limit over a 24-hour moving window; the exact cap varies by account and should be read live via IN… Bulk support: accepts ig_user_ids, creation_ids for batched execution.
instagram_send_image
accountimage_url*ig_user_idig_user_idsrecipient_id*recipient_ids
+1
Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. Bulk support: accepts ig_user_ids,… Send an image via Instagram DM to a specific user. Each send modifies inbox state; avoid bulk or automated sends without explicit user approval. Bulk support: accepts ig_user_ids, recipient_ids for batched execution.
instagram_send_text_message
text*accountig_user_idig_user_idsrecipient_id*recipient_ids
+3
Send a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Cre… Send a text message to an Instagram user via DM in an existing conversation. Cannot initiate new DM threads — a prior conversation must exist. Requires an Instagram Business or Creator account with messaging permissions. Fails with error_subcode 2534022 if outside the messaging window; do not retry these failures. Bulk support: accepts ig_user_ids, recipient_ids, reply_to_message_ids for batched execution.
marketplace
limitqueryactionmcp_idmessagetool_id
+17
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF",… The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
report_bug
contextmessage*conversation
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
show_version
read-only
Show the current MCP platform and adapter versions. Show the current MCP platform and adapter versions.
toolkit_info
read-only