Instagram MCP server
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.
| Capability | Supported in SocialRobot |
|---|---|
| Accounts | Instagram Business and Creator accounts authorized through Instagram Login. Personal accounts need to switch to a professional account for API publishing. |
| Post formats | Feed photos, carousels, Reels, and Stories. Supply supported images or video through the media tools or public URLs. |
| Network options | First comments, image alt text, people tags, collaborators, Reel covers, share-to-feed, and AI-generated content disclosure where supported by the format. |
| Analytics | Account and post insights, plus personalized posting-time guidance based on past performance. Available metrics depend on Instagram permissions and post format. |
| Requirements and limits | 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. |
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/mcpSign 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.
- 1Open Customize → Connectors, then + Add → Add custom connector.
- 2Name it SocialRobot.
- 3URL: https://socialrobot.io/api/mcp
- 4Sign in when Claude asks, then try: schedule tomorrow's Instagram post.
claude mcp add --transport http socialrobot https://socialrobot.io/api/mcpYou need a paid plan. OpenAI keeps renaming this screen (connectors, apps, plugins), but it's still a form, not a coding project.
- 1Go to chatgpt.com/plugins → Add → Create MCP App. If that's missing, turn on Developer mode in Settings first.
- 2Name it SocialRobot.
- 3Server URL: https://socialrobot.io/api/mcp. Authentication: OAuth.
- 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.
- 1Click Add to Cursor to sign in, or paste one of the JSON blocks below.
- 2Without a key, sign in when Cursor says Needs login. With a key, replace sk_YOUR_API_KEY and skip that prompt.
- 3Ask Cursor to schedule a post.
This version signs you in. Use it if you don't want to create a 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_.
{
"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.
- 1Click Add to VS Code to sign in, or run MCP: Add Server and paste one of the snippets.
- 2Choose HTTP. URL: https://socialrobot.io/api/mcp. Name: SocialRobot.
- 3MCP: List Servers → SocialRobot → Start Server.
- 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.
{
"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_.
{
"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.
- 1Open mcp_config.json and paste either snippet.
- 2Refresh Cascade MCP settings (or restart Windsurf).
- 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.
{
"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_.
{
"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.
- 1Open Settings → AI → MCP Servers, or edit settings.json.
- 2Paste the first snippet to sign in, or the second and swap in your key.
- 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.
{
"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_.
{
"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.
- 1Open the client's MCP config. It's usually called mcp.json.
- 2Paste the first block to sign in, or the second and replace sk_YOUR_API_KEY.
- 3Ask it to schedule a post.
This version signs you in. Use it if you don't want to create a 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_.
{
"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.
| MCP tool | What it does |
|---|---|
list_connected_accounts | Find the accounts and IDs available to your SocialRobot user. |
list_projects | Find your projects and IDs before reading their profiles. |
get_project_profile | Read the project profile and writing guide before drafting. |
get_project_tags | Read the hashtags per network and Threads topics a project uses most. |
get_media_upload_url | Get a presigned URL to upload file bytes, then use the returned media URL in a post. |
upload_media | Import media from a public HTTPS URL or a file shared by ChatGPT (up to 50 MB). |
create_post | Save a private draft, schedule a post, or publish now. |
list_posts | Read your drafts, scheduled posts, and publication status. |
update_post | Replace the content and targets of an unpublished post. Include any media you want to keep. |
reschedule_post | Move an unpublished post to a new future publication time. |
delete_post | Remove a draft or scheduled post from SocialRobot. |
get_account_analytics | Read supported metrics for a connected account. |
get_post_analytics | Read supported metrics for a published post. |
get_posts_with_analytics | List published posts with available metrics, using date ranges where supported. |
get_performance_report | Rank the posts that did best across your accounts, with totals per account. |
get_follower_demographics | Read available audience demographics for the connected account. |
instagram_best_post_times | Get 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/monthFree
2 social accounts and 15 scheduled posts per month. MCP included. X is excluded.
$19/monthStarter
5 social accounts and unlimited scheduled posts. MCP included. X is excluded.
$29/monthPro
20 social accounts and unlimited scheduled posts, including X. MCP included.
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?
What can I publish and schedule?
Can this Instagram MCP server answer DMs or manage ads?
Will it always ask me to approve a post?
One MCP server. Your social networks.
Choose a network for its supported formats, account requirements, example requests, and setup. Every page connects to the same SocialRobot server.
Pinterest MCP server
Pin scheduling, board tools, destination links, and top-Pin analytics.
Connect PinterestX MCP server (Twitter)
Text, images, video, and connected threads. Available on Pro.
Connect X (Twitter)LinkedIn MCP server
Personal profiles, Company Pages, documents, polls, and analytics.
Connect LinkedInBluesky MCP server
Text, photos, video, and scheduling alongside your other networks.
Connect BlueskyTikTok MCP server
Videos, photo slideshows, creator settings, and TikTok inbox drafts.
Connect TikTokMastodon MCP server
Instance connection, visibility, content warnings, alt text, and polls.
Connect MastodonMeta Threads MCP server
Text, media, connected threads of up to 20 posts, and insights.
Connect Meta ThreadsFacebook MCP server
Facebook Page publishing, scheduled posts, and Page insights.
Connect Facebook
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 freeFree plan. No credit card required.












