Verify the MCP is configured + ready: accounts present, token backend, Graph reachability.

Does a live GET on the default account's profile if one is configured. Safe to call anytime; never mutates. Returns ok=false with a hint when no account is set.

List configured Instagram accounts (labels + ig_user_id + default flag). Never returns tokens.

Store an Instagram Business/Creator account for use by every tool.

label a short key you choose (e.g. "onde", "mycelium", "client-acme") access_token a long-lived Instagram Graph API token (stored in the OS keychain) ig_user_id the Instagram Business Account id (numeric) app_secret optional Meta app secret — enables appsecret_proof call hardening make_default set true to make this the account used when account is omitted

The token is written to the macOS keychain (or a chmod-600 file fallback) and is NEVER echoed back or logged.

Set which configured account is used when a tool's account arg is omitted.

Remove a configured account + delete its stored token from the keychain.

Live profile snapshot for one account: username, name, followers, media count, etc.

Return the account's public profile fields (followers, follows, media count, bio, website).

List recent media (posts/reels) for the account, newest first. limit 1-100 (default 25).

Return full fields for one media object by id (caption, type, permalink, like/comment counts).

Account-level analytics (reach, impressions, profile views, follower count).

metrics: comma-separated Graph metric names (default reach,impressions,profile_views, follower_count). period: day|week|days_28|lifetime. Exact available metrics vary by Graph API version; on a mismatch the Meta error names the correct metric.

Per-post analytics (reach, saves, likes, comments, shares, total interactions).

metrics override is comma-separated; defaults suit feed posts. Reels/stories expose different metrics (e.g. plays, navigation) — pass them explicitly if needed.

Follower demographics (age, gender, country, city).

Requires the account to have >=100 followers (Meta privacy floor) — below that the Graph returns an error, surfaced cleanly. Newer Graph versions use metric= follower_demographics with metric_type=total_value + breakdown=age|gender|country|city and a timeframe (last_14_days|last_30_days|last_90_days|prev_month) for engaged-audience metrics. All are override-able.

Remaining posts in the rolling 24h publishing quota (Instagram caps API posts/day).

Publish a single image to the feed.

image_url must be a PUBLIC https URL (Instagram fetches the bytes itself). caption <= 2200 chars. Two-step Graph flow (create container -> publish) handled internally.

Publish a video to the feed. video_url must be a PUBLIC https URL.

Video containers process asynchronously; this polls status up to 90s before publishing.

Publish a Reel. video_url must be a PUBLIC https URL.

share_to_feed also surfaces the reel in the main grid. cover_url (optional) sets the thumbnail. Reel containers process asynchronously (polled up to 90s).

Publish a multi-image carousel (2-10 images). Each image_url must be a PUBLIC https URL.

Creates one child container per image (is_carousel_item) then a CAROUSEL parent, then publishes.

Publish a Story (image OR video). Exactly one of image_url / video_url, PUBLIC https.

List comments on a media object (text, username, timestamp, like_count, hidden).

Reply to a comment. message <= 2200 chars. Returns the new comment id.

Hide (or unhide) a comment from public view. hide=false unhides.

Permanently delete a comment you own (or a comment on your media). Irreversible.

Resolve a hashtag name to its Graph id (needed before get_hashtag_media).

Recent or top media for a hashtag id. edge=top_media|recent_media. limit 1-100.

Get the hashtag_id from search_hashtag first. Subject to Meta's 30-unique-hashtags per-7-days query limit per account.

List recent media where the account is @-mentioned (tags edge).

Public profile + (optionally) recent media for ANY business/creator account by username.

Read-only competitor/prospect research via the business_discovery edge. Only works for Professional accounts (not personal). with_media pulls up to media_limit recent posts.

List Instagram DM conversations. REQUIRES Meta App Review (instagram_manage_messages).

Read messages in a DM conversation. REQUIRES Meta App Review (instagram_manage_messages).

Send a DM. REQUIRES Meta App Review + the 24-hour standard-messaging window.

recipient_id is the IGSID (Instagram-scoped user id) of the recipient. Outside the 24h customer-service window a paid message tag is required (not handled here).