Boring Instagram Publisher#

Publish photos, carousels, and Reels to Instagram. Powered by Boring.

Security & Data Handling#

• MCP link is a credential: Your MCP Server URL ( https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly.
• Token scope: The embedded token grants publish access to your connected social media accounts. It can create posts, upload media, and manage scheduled posts on the platforms you have connected. It cannot access your social media passwords or modify account settings.
• Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
• Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
• No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
• Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.

Prerequisites#

1. Sign up at boring.aiagent-me.com with Google
2. Connect Instagram — requires an Instagram Business or Creator account (personal accounts not supported)
3. Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
4. Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Workflow#

Step 1: List Accounts#

Call boring_list_accounts and filter for instagram platform.

Step 2: Confirm Content#

IMPORTANT: Instagram requires media. Text-only posts are NOT supported.

TypeMediaSpecsPhoto1 imageJPG/PNG, 320x320 to 1440x1440Carousel2-10 imagesAll images must have matching aspect ratiosReels1 videoMP4, 9:16 vertical, up to 90 seconds

• Caption: Up to 2,200 characters
• If the user only provides text with no media, inform them that Instagram requires at least one image or video

Step 3: Prepare Media#

Media must be publicly accessible URLs:

• Local files: boring_upload_file with file_path → returns public URL
• External URLs: boring_upload_from_url → re-hosts to Boring cloud storage
• Google Drive links: Pass directly to media_urls

Step 4: Publish or Schedule#

Call boring_publish_post:

text

boring_publish_post(
  account_id="<instagram_account_id>",
  platform="instagram",
  text="Your caption here #hashtags",
  media_urls=["https://...image.jpg"]
)

For carousel (2-10 images):

text

boring_publish_post(
  account_id="<instagram_account_id>",
  platform="instagram",
  text="Swipe to see more!",
  media_urls=["https://...1.jpg", "https://...2.jpg", "https://...3.jpg"]
)

For Reels (video):

text

boring_publish_post(
  account_id="<instagram_account_id>",
  platform="instagram",
  text="Check out this Reel!",
  media_urls=["https://...video.mp4"]
)

Schedule: Add scheduled_at in ISO 8601 format:

text

boring_publish_post(..., scheduled_at="2025-12-25T10:00:00Z")

Step 5: Report#

Show the post ID and confirmation. If scheduled, show the scheduled time.

Managing Scheduled Posts#

• View: boring_list_scheduled_posts with platform: "instagram"
• Cancel: boring_cancel_scheduled_post with scheduled_post_id

Instagram-Specific Notes#

• Media is mandatory — always need at least 1 image or video
• Carousel aspect ratios: All images in a carousel must have the same aspect ratio
• Reels: Vertical video (9:16), up to 90 seconds
• Token: 60-day long-lived token with auto-refresh
• Rate Limit: 200 calls/hour per user, 4,800/hour per app
• Permissions: instagram_business_content_publish, instagram_business_basic

Error Handling#

ErrorSolutionMediaRequiredInstagram requires media — ask user for an image or videoInvalidCarouselSizeCarousel needs 2-10 imagesCarouselCreationFailedCheck that all images have the same aspect ratioMediaTooLargeImages max 8MBTokenExpiredReconnect at boring.aiagent-me.com

Documentation#

Full API docs: boring-doc.aiagent-me.com