Facebook MCP server: let Claude or any agent post to your Facebook Page

Set it up and post, step by step

1. Add PostWire's MCP server to your agent

   In Claude, open PostWire in the connector directory and press Connect. Anywhere else, add the remote server https://postwire.io/api/mcp (Streamable HTTP; OAuth sign-in or an API key) — in Claude Code: claude mcp add --transport http postwire https://postwire.io/api/mcp. Cursor, VS Code, Windsurf, Codex and Gemini CLI configs: MCP client configs.

2. Sign in with your email

   The first time the agent uses a PostWire tool, a sign-in window asks for your email and a 6-digit code; that also creates a free PostWire account if you have none. No password and no card. Agents that cannot do OAuth send an API key instead (dashboard → API & MCP → Copy key).

3. Connect your Facebook Page

   Ask "connect my Facebook Page". The agent calls create_connect_link and gives you a one-hour link. Facebook shows "Continue as <your name>", then asks which Pages PostWire may use: tick the Page you want to post to and press Save. Pages you manage directly and Pages inside a Business Portfolio both appear. PostWire never sees your Facebook password.

4. Let PostWire write the post

   "Write a Facebook post about our Saturday open day, and an Instagram caption for the same photo." generate_posts returns one draft per network and publishes nothing. Facebook's draft is short — 40 to 80 characters when the idea allows, under 250 otherwise — with the hook in the first 125 characters (where the mobile feed cuts), 1 to 3 hashtags and no "like if you agree" bait. A link can stay in the body.

5. Add a photo or a video, if you want one

   Pass a public https link as photo_url or video_url. A file on your phone or laptop gets there through create_upload_link: a 24-hour page where you pick the file (up to 250 MB on the free plan and 1 GB on paid plans), then get_uploaded_file returns its media_url. Chat attachments never reach an MCP server, so this is how your own photo gets there.

6. Publish, or schedule it

   After you approve the draft, the agent calls post_to_social (or schedule_post with a run_at time, or "next_slot" for your next free queue slot). A photo post to the Page looks like this:

   {
     "name": "post_to_social",
     "arguments": {
       "platforms": ["facebook"],
       "per_platform": { "facebook": { "text": "Open day this Saturday, 10 to 2. Coffee is on us ☕ #openday" } },
       "photo_url": "https://postwire.io/m/…/open-day.jpg"
     }
   }

7. Open the post

   The result carries the post's id, its link (https://facebook.com/…) and the Page it went to. list_scheduled_posts shows what is still queued and cancel_scheduled_post removes one before it goes out.

Reels and Stories go through the REST API: POST /api/post or POST /api/schedule with "options": {"facebook": {"post_type": "reels"}} (needs a video) or "story" (a photo or a video). See network options. Prefer to set it up by hand first? Open the dashboard, connect the account under Accounts and copy your key under API & MCP.