Boring Facebook Publisher#

Publish and schedule posts to Facebook Pages. Powered by Boring.

Security & Data Handling#

• MCP link is a credential: Your MCP Server URL contains an embedded authentication token. Treat it like a password — do not share it publicly. Regenerate anytime in Settings.
• Media uploads: Local files or URLs are uploaded to Boring's Google Cloud Storage to make them accessible for publishing. Social media APIs require publicly accessible media URLs.
• Data flow: Your content and media are sent from Boring's server to Facebook's API on your behalf via your connected OAuth token.
• No local credentials: No local API keys or environment variables needed. All auth is embedded in the MCP link.

Prerequisites#

1. Sign up at boring.aiagent-me.com with Google
2. Connect Facebook — requires admin access to a Facebook Page
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 Facebook Accounts#

Call boring_list_accounts and filter for facebook platform accounts. Show the user their connected Pages.

Step 2: Confirm Content#

Ask the user what to post. Facebook supports:

TypeDescriptionMediaTextCaption-only postNonePhotoSingle image post1 image (JPG/PNG, max 4MB)AlbumMulti-image post2-10 imagesVideoVideo post1 video (MP4/MOV, max 1GB, max 240 min)

Step 3: Prepare Media#

If the user provides media:

• Local file: boring_upload_file with file_path
• URL: boring_upload_from_url with the URL
• Google Drive link: Pass directly to media_urls

Step 4: Publish or Schedule#

Call boring_publish_post with:

text

account_id: "<facebook_account_id>"
platform: "facebook"
text: "Your post content here"
media_urls: ["https://...image.jpg"]  (optional)
scheduled_at: "2025-12-25T10:00:00Z"  (optional, for scheduling)

For immediate publish: omit scheduled_at For scheduling: include scheduled_at in ISO 8601 format

Step 5: Report#

Show the user:

• Post ID and success confirmation
• If scheduled: the scheduled time and post ID

Managing Scheduled Posts#

• View scheduled: boring_list_scheduled_posts with platform: "facebook"
• Cancel: boring_cancel_scheduled_post with the scheduled_post_id

Facebook-Specific Notes#

• Token: Facebook Page tokens never expire — no re-authentication needed
• Data Access: Valid for 90 days (auto-managed by Boring)
• Rate Limit: 200 API calls/hour per Page
• Permissions: pages_manage_posts, pages_read_engagement
• Aspect Ratio: 16:9 or 9:16 recommended for videos

Error Handling#

ErrorSolutionInvalidApiKeyMCP link may be invalid — regenerate it at boring.aiagent-me.com SettingsInvalidAccountIdRun boring_list_accounts to get valid account IDsMediaTooLargeImages max 4MB, videos max 1GBPublishingFailedCheck if Page permissions are correct at boring.aiagent-me.comRateLimitExceededWait and retry — 200 calls/hour limit

Examples#

Text post:

text

boring_publish_post(account_id="abc", platform="facebook", text="Hello from Boring!")

Photo post:

text

boring_publish_post(account_id="abc", platform="facebook", text="Check this out!", media_urls=["https://example.com/photo.jpg"])

Schedule for tomorrow 9 AM UTC:

text

boring_publish_post(account_id="abc", platform="facebook", text="Scheduled post!", scheduled_at="2025-12-26T09:00:00Z")

Documentation#

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