Refract Social Media MCP
กำหนดเวลาและเผยแพร่โพสต์ไปยังโซเชียลเน็ตเวิร์ก 13 แห่ง (X, TikTok, YouTube, Bluesky, Mastodon, Pinterest และอื่น ๆ) จาก Claude, ChatGPT หรือไคลเอนต์ MCP ใดก็ได้ โฮสต์ให้ใช้งาน ลงชื่อเข้าใช้ด้วย OAuth ไม่ต้องใช้ API key
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://mcp.refract.social'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
What it can do.
The server’s 21 tools, grouped by job, as your AI app sees them. An app only gets the ones its level allows.
Write drafts
create-draftCreates a draft post in a workspace with its text, accounts and optional media.delete-draftDeletes a draft, or a post waiting for approval (its approval request goes too).restore-draftBrings back a draft deleted in the last 30 days, with delete-draft or in Refract.
Upload images and videos
upload-mediaAdds an image or video to a workspace's media library from a public link, or from a file the person attached in ChatGPT.request-media-uploadGives a one-time link for uploading an image or video from your disk or code sandbox, such as a file the person attached in the chat.
Edit posts that haven’t gone out
update-draftChanges a post that hasn't gone out yet: its text, its text and post fields per platform, its accounts or its media.
Check a post before it goes out
check-postRuns the composer's checks on a saved post and lists its issues per platform, each with a sentence.
Find free posting times
find-slotsFinds the next free posting times for some accounts: the workspace's posting times (its queue) that none of them uses yet, in the workspace's time zone.
Schedule, publish or send for approval
send-for-approvalSends a draft to the team for approval, to go out at a time you pick or at the workspace's next free posting time.schedule-postSchedules a draft to go out at a time you pick or at the workspace's next free posting time.publish-nowPublishes a draft or a scheduled post on every account it goes to, as soon as it can.
Move or unschedule posts
reschedule-postMoves a scheduled post, or one waiting for approval, to a new time in the workspace's time zone.unschedule-postTakes a scheduled post, or one waiting for approval, off the schedule and back to the drafts.
Read your workspaces, accounts and posts
list-workspacesLists the Refract workspaces this connection can use, with each one's time zone and permissions.list-accountsLists the social accounts connected in a workspace.list-postsLists a workspace's posts, newest first, with their status and scheduled time.get-postGets one post with its text, accounts and their status, media, scheduled time and history.
Read analytics
read-analyticsReads a workspace's analytics for a period: totals against the period before, each network's numbers, the best posts and gaps.
Fix posts that went out
retry-postSends a post again to one account where it failed, and only that account.edit-published-postChanges the text and settings of a published post on one of its accounts.remove-published-postRemoves a published post from the network of one of its accounts.
Connect it in a minute.
Add the server address to your AI app, then sign in to Refract when it asks.
How sign-in works
- Your AI app opens Refract in your browser and you sign in there. There’s no API key to paste, and the app never sees your password.
- You pick the workspaces it may use and one of two levels: Draft and send for approval, which works like a Contributor and holds everything for a teammate’s approval, or Schedule and publish, which works like an Editor. It never gets more than your own role.
- Select Allow. Tools the level doesn’t cover aren’t offered to the app at all. Admins can remove any connected app in Settings › API and agents.
- The server supports OAuth discovery, dynamic client registration and PKCE, so most apps find the sign-in on their own. Every tool and parameter is in the MCP server technical reference.
Steps for each app
Claude
- In Refract, open Settings › API and agents, select Connect Claude, pick the workspaces and what Claude can do, then select Continue in Claude.
- In Claude, add a custom connector named Refract with this address.
- Select Connect, then sign in to Refract if it asks.
- Check the workspaces and what Claude can do, then select Allow.
textCopy
https://mcp.refract.social
ChatGPT
- In ChatGPT on the web, open Plugins, select +, then Add custom MCP server.
- Name it Refract, paste the address and choose OAuth.
- Accept the risk warning, select Create as a plugin, then sign in to Refract and pick what ChatGPT can do.
textCopy
https://mcp.refract.social
Claude Code
- Run this in your terminal, then type /mcp and sign in.
bashCopy
claude mcp add --transport http refract https://mcp.refract.social
Cursor
- Add this to.cursor/mcp.json, then sign in when Cursor asks.
.cursor/mcp.jsonCopy
{ "mcpServers": { "refract": { "url": "https://mcp.refract.social" } } }
VS Code
- Add this to.mcp.json in your workspace root, or to ~/.copilot/mcp-config.json for every workspace, then sign in when VS Code asks.
.mcp.jsonCopy
{ "mcpServers": { "refract": { "type": "http", "url": "https://mcp.refract.social" } } }
Other apps
- Add a remote MCP server (Streamable HTTP) with the address above. Refract signs you in through your browser with OAuth.
textCopy
https://mcp.refract.social
Claude: custom connectors work on every Claude plan (Free, Pro, Max, Ultra, Team and Enterprise). Free is limited to one, and on Team and Enterprise an owner adds the connector first.
ChatGPT: full MCP support, including tools that write, is on ChatGPT Business and Enterprise/Edu, on the web only. On Business, only admins and owners can add it. ChatGPT Pro can connect custom servers with read/fetch permissions only.
Example requests.
Once Refract is connected, ask in plain words. A few to start with:
- Turn this blog post into versions for X, Bluesky and Mastodon and schedule them for tomorrow at 9:00: https://kolo.coffee/blog/guji-roast Copy
- Upload the video at https://kolo.coffee/media/guji-roast.mp4, then draft a YouTube post with a title and tags and a TikTok post, both for the next free posting time. Copy
- What’s scheduled on X and Bluesky next week, and is anything still waiting for approval? Copy
- Move Thursday’s Mastodon post to Friday at 14:00 and make it shorter. Copy
- Which of my posts failed this month, and why? Copy
- How did our posts do over the last 30 days, and which ones did best? Copy
What it can’t do yet.
None of the server’s tools can:
- Change workspace settings, posting times or billing.
- Invite, remove or change team members.
- Connect or reconnect social accounts: that happens in Refract.
- Change your brand voice or rules, or make images in Studio.
- Post to networks that are Coming soon, or reach workspaces you didn’t pick when you connected.
Questions and answers.
Which plans include the MCP server?
Every plan: Creator, Business, Agency and Agency Plus, from $10 a month. It’s on the 14-day free trial too.
Does it work with ChatGPT?
Yes, on the plans where OpenAI allows custom MCP servers. Full MCP support, including tools that write, is on ChatGPT Business and Enterprise/Edu, in ChatGPT on the web; on Business, an admin or owner adds it. OpenAI says ChatGPT Pro can connect custom servers with read/fetch permissions only. Source: Connecting custom MCP servers in ChatGPT, checked 11 November 2026.
Which networks does it support?
The 13 networks anyone can connect in Refract today: TikTok, YouTube, X, Pinterest, Bluesky, Mastodon, Telegram, WordPress, Discord, Tumblr, Slack, Pixelfed and DEV. Coming soon: Instagram, Facebook, Threads, LinkedIn, Google Business Profile and Lemmy.
Does it post without asking me?
Not unless you let it. At Draft and send for approval, everything it writes waits for a teammate to approve it. At Schedule and publish, for 1, 7 or 30 days or until you change it, it can schedule posts and publish them now, and its tools tell your AI to ask you before anything that can’t be undone. Even then nothing it schedules goes out sooner than 5 minutes after it asks, and the bell in Refract tells you when it publishes now, so you can stop the post in time. If the workspace asks for approval from AI agents and tokens (Business plans and up), those posts wait for approval too.
Is it open source?
No. The server is part of the Refract app and isn’t open source. The refract-mcp repository on GitHub is public, but it holds only the listing metadata for the MCP Registry and LobeHub, with no licence.
How is it different from Refract’s API?
The REST API is for code you write: an admin creates a token and your code calls its endpoints, as the API docs describe. The MCP server is for AI assistants: you sign in with OAuth instead of pasting a token, the assistant finds its 21 tools by itself, and you ask in plain words.
Sources
- OpenAI: Connecting custom MCP servers in ChatGPT
- Anthropic: Get started with custom connectors using remote MCP
- Claude Code: Connect Claude Code to tools via MCP
- Cursor: Model Context Protocol (MCP)
- VS Code: MCP configuration reference
- Official MCP Registry: social.refract/refract
- GitHub: anpsthemes-wp-themes/refract-mcp