socialrobot
SocialRobot MCP

Instagram MCP server

Schedule Instagram photos, carousels, Reels, and Stories from Claude, ChatGPT, or Cursor. Connect your professional account once with SocialRobot.
ClaudeChatGPTCursor

Example workflow with sample content.

MCP included on Free. No credit card required.

What you can do on Instagram

Connect your account in SocialRobot, then use these capabilities from Claude, ChatGPT, Cursor, or another MCP client.

What you can do on Instagram
CapabilitySupported in SocialRobot
AccountsInstagram Business and Creator accounts authorized through Instagram Login. Personal accounts need to switch to a professional account for API publishing.
Post formatsFeed photos, carousels, Reels, and Stories. Supply supported images or video through the media tools or public URLs.
Network optionsFirst comments, image alt text, people tags, collaborators, Reel covers, share-to-feed, and AI-generated content disclosure where supported by the format.
AnalyticsAccount and post insights, plus personalized posting-time guidance based on past performance. Available metrics depend on Instagram permissions and post format.
Requirements and limitsPublishing requires a professional account. First comments may need reconnection for comment permission. Shopping tags, paid partnership labels, and location tags are not available on this integration.
Explore all Instagram features

Three requests to try first

Give the assistant your content, name the connected account, and specify the date, time, and timezone. These examples show what to ask and what happens next.

Queue a carousel

“Schedule these three photos as one Instagram carousel tomorrow at 6 PM Europe/Amsterdam. Write a short caption about our new ceramic cups.”

What happens: The assistant uploads the supplied photos and schedules one carousel for your connected professional account.

Prepare a Reel with its cover

“Use this public MP4 URL for an Instagram Reel and this image URL as its cover. Add a first comment with our opening hours and save a draft.”

What happens: The Reel is saved for review with the supplied video, cover, and first comment. Provide real media URLs before asking.

Pick a time from your own data

“Check the best posting times for my Instagram account, then list my scheduled posts for next week. Suggest a better slot for the product carousel.”

What happens: The assistant reads posting-time guidance and your schedule. Ask it to reschedule once you choose the slot.

Connect Instagram to Claude, ChatGPT, or Cursor

First create a SocialRobot account and connect Instagram under Accounts. Then add the server below in your AI client. SocialRobot manages the network connection; you do not need to build your own developer app.

Hosted MCP endpoint

https://socialrobot.io/api/mcp

Sign in with OAuth, or use a scoped API key from SocialRobot with Authorization: Bearer sk_YOUR_API_KEY. The same endpoint works for every supported network.

Works in Claude on the web, desktop and mobile, on every plan (Free allows one custom connector). Claude Code uses the terminal command below.

  1. 1Open Customize → Connectors, then + Add → Add custom connector.
  2. 2Name it SocialRobot.
  3. 3URL: https://socialrobot.io/api/mcp
  4. 4Sign in when Claude asks, then try: schedule tomorrow's Instagram post.
terminal
claude mcp add --transport http socialrobot https://socialrobot.io/api/mcp

You need a paid plan. OpenAI keeps renaming this screen (connectors, apps, plugins), but it's still a form, not a coding project.

  1. 1Go to chatgpt.com/plugins → Add → Create MCP App. If that's missing, turn on Developer mode in Settings first.
  2. 2Name it SocialRobot.
  3. 3Server URL: https://socialrobot.io/api/mcp. Authentication: OAuth.
  4. 4Create it, sign in, then pick SocialRobot from the + menu when you start a chat.

One click to sign in, or paste either mcp.json block into .cursor/mcp.json.

  1. 1Click Add to Cursor to sign in, or paste one of the JSON blocks below.
  2. 2Without a key, sign in when Cursor says Needs login. With a key, replace sk_YOUR_API_KEY and skip that prompt.
  3. 3Ask Cursor to schedule a post.

This version signs you in. Use it if you don't want to create a key.

mcp.json without API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp"
    }
  }
}

This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.

mcp.json with API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

One click to sign in, or drop either mcp.json block into your workspace.

  1. 1Click Add to VS Code to sign in, or run MCP: Add Server and paste one of the snippets.
  2. 2Choose HTTP. URL: https://socialrobot.io/api/mcp. Name: SocialRobot.
  3. 3MCP: List Servers → SocialRobot → Start Server.
  4. 4Sign in if you used the first snippet. The API-key snippet skips that.

This version signs you in. Use it if you don't want to create a key.

mcp.json without API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp"
    }
  }
}

This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.

mcp.json with API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

Put one of these in ~/.codeium/windsurf/mcp_config.json. Windsurf wants serverUrl, not url.

  1. 1Open mcp_config.json and paste either snippet.
  2. 2Refresh Cascade MCP settings (or restart Windsurf).
  3. 3Sign in on the first snippet. On the second, replace sk_YOUR_API_KEY first.

This version signs you in. Use it if you don't want to create a key.

mcp_config.json without API key
{
  "mcpServers": {
    "socialrobot": {
      "serverUrl": "https://socialrobot.io/api/mcp"
    }
  }
}

This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.

mcp_config.json with API key
{
  "mcpServers": {
    "socialrobot": {
      "serverUrl": "https://socialrobot.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

The SocialRobot block goes under context_servers in settings.json. Sign-in or an API key, your pick.

  1. 1Open Settings → AI → MCP Servers, or edit settings.json.
  2. 2Paste the first snippet to sign in, or the second and swap in your key.
  3. 3Sign in if Zed asks, then ask it to schedule a post.

This version signs you in. Use it if you don't want to create a key.

settings.json without API key
{
  "context_servers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp"
    }
  }
}

This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.

settings.json with API key
{
  "context_servers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

Any app that can add a custom MCP server. Paste one of these into its mcp.json.

  1. 1Open the client's MCP config. It's usually called mcp.json.
  2. 2Paste the first block to sign in, or the second and replace sk_YOUR_API_KEY.
  3. 3Ask it to schedule a post.

This version signs you in. Use it if you don't want to create a key.

mcp.json without API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp"
    }
  }
}

This version uses a key from Scheduler → API Keys. Paste it over sk_YOUR_API_KEY. New keys start with sk_.

mcp.json with API key
{
  "mcpServers": {
    "socialrobot": {
      "url": "https://socialrobot.io/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

MCP access is included in your SocialRobot plan. Your AI client may have its own subscription or administrator requirements for custom connectors.

The tools behind your requests

The assistant selects tools from the permissions you grant. Publishing tools work on your connected accounts; network-specific tools appear below where supported.

The tools behind your requests
MCP toolWhat it does
list_connected_accountsFind the accounts and IDs available to your SocialRobot user.
list_projectsFind your projects and IDs before reading their profiles.
get_project_profileRead the project profile and writing guide before drafting.
get_project_tagsRead the hashtags per network and Threads topics a project uses most.
get_media_upload_urlGet a presigned URL to upload file bytes, then use the returned media URL in a post.
upload_mediaImport media from a public HTTPS URL or a file shared by ChatGPT (up to 50 MB).
create_postSave a private draft, schedule a post, or publish now.
list_postsRead your drafts, scheduled posts, and publication status.
update_postReplace the content and targets of an unpublished post. Include any media you want to keep.
reschedule_postMove an unpublished post to a new future publication time.
delete_postRemove a draft or scheduled post from SocialRobot.
get_account_analyticsRead supported metrics for a connected account.
get_post_analyticsRead supported metrics for a published post.
get_posts_with_analyticsList published posts with available metrics, using date ranges where supported.
get_performance_reportRank the posts that did best across your accounts, with totals per account.
get_follower_demographicsRead available audience demographics for the connected account.
instagram_best_post_timesGet posting-time guidance based on the account’s past performance.

You control the publishing mode: save a draft, schedule for later, or publish now. MCP can schedule or publish without a separate human approval step. Ask explicitly for a draft when you want to review it first.

MCP is included in your plan

No separate MCP add-on. Your connected-account and scheduled-post limits are the same as in the SocialRobot dashboard. Prices below are USD with monthly billing.

$0/month

Free

2 social accounts and 15 scheduled posts per month. MCP included. X is excluded.

$19/month

Starter

5 social accounts and unlimited scheduled posts. MCP included. X is excluded.

$29/month

Pro

20 social accounts and unlimited scheduled posts, including X. MCP included.

Available on Free, Starter, and ProSee full pricing and annual options

If the first request does not work

Your account is missing

Connect the network in SocialRobot first. Ask the assistant to list your connected accounts, then name the right one in your request. Check that you signed into the same SocialRobot account in both places.

The assistant cannot access a tool

Reconnect the MCP server if OAuth has expired. For API keys, check the Bearer header, whether the key was revoked, and its scopes. Reading posts, publishing, media uploads, and analytics need their corresponding permissions.

A photo or video is rejected

Use the media upload tools or a public HTTPS media URL. Ask the assistant to inspect the validation error. Check the network’s file type, size, and aspect requirements; browser-only media conversions are not performed by an MCP client.

The time or publishing mode is wrong

Give an exact date, time, and timezone. Ask for a private draft to review first, a scheduled post for later, or immediate publishing. Check the result with list_posts. You can reschedule an unpublished post; deleting it in SocialRobot does not recall a post already live on the network.

Publishing requires a professional account. First comments may need reconnection for comment permission. Shopping tags, paid partnership labels, and location tags are not available on this integration.

Instagram MCP server questions

Which accounts can I connect?

Instagram Business and Creator accounts authorized through Instagram Login. Personal accounts need to switch to a professional account for API publishing.

What can I publish and schedule?

Feed photos, carousels, Reels, and Stories. Supply supported images or video through the media tools or public URLs. First comments, image alt text, people tags, collaborators, Reel covers, share-to-feed, and AI-generated content disclosure where supported by the format.

Can this Instagram MCP server answer DMs or manage ads?

The current MCP tools cover publishing, schedules, project context, and supported insights. They do not expose an Instagram DM inbox or advertising campaign management. A first comment on your own post is supported; a general comment-moderation tool is not.

Will it always ask me to approve a post?

You control the publishing mode: save a draft, schedule for later, or publish now. MCP can schedule or publish without a separate human approval step. Ask explicitly for a draft when you want to review it first.

Start free

Your next post starts here.

Connect your accounts and try it with a real post. Two accounts and fifteen posts a month, free.

Start free

Free plan. No credit card required.