# Refract

> Refract is an MCP server for marketing and seo. Draft, approve and schedule social posts from Claude, ChatGPT or Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $10 a month
- **Platforms:** API, Web
- **Website:** https://refract.social/mcp
- **Repository:** https://github.com/anpsthemes-wp-themes/refract-mcp
- **MCP Registry name:** social.refract/refract
- **Categories:** marketing and SEO, communication
- **Listing updated:** 2026-11-14

## About

Refract is a social media publishing app, and this hosted server lets an AI assistant work inside it. You sign in with OAuth, with no API key to paste, then choose which workspaces the app can reach and one of two levels. The lower level drafts and sends posts for approval; the higher level also schedules, publishes and edits posts that have gone out.

Tools cover the full path: create and update drafts, upload media from a link or attached file, run the composer's checks per platform, find free posting times in the workspace's time zone, schedule, reschedule or publish, and read workspaces, accounts and posts. Tools an app is not allowed are never offered, and where a workspace requires approval for AI agents, everything an assistant schedules waits for a teammate.

Refract connects 13 networks today, and every plan includes MCP access. A 14-day trial covers every feature without a card.

## Features

- **Draft and schedule:** Create drafts, then schedule or publish them across connected accounts.
- **Approval workflow:** Send drafts for team approval, and agent posts can be forced to wait for sign-off.
- **Pre-flight checks:** check-post lists issues per platform before a post goes out.
- **Free-slot finder:** Finds the next unused posting times in the workspace's time zone.
- **Media upload:** Add images and video from a link, or from a file attached in ChatGPT.
- **Scoped access:** Choose workspaces and a permission level per connection; admins can revoke.

## Good for

- Have Claude draft a week of posts into a workspace
- Queue approved posts at the next free slots
- Check a post for platform-specific issues
- Reschedule a post that needs a new time
- Review what is scheduled across accounts

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http refract https://mcp.refract.social
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.refract.social
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "refract": {
      "url": "https://mcp.refract.social"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "refract": {
      "type": "http",
      "url": "https://mcp.refract.social"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "refract": {
      "serverUrl": "https://mcp.refract.social"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "refract": {
      "type": "http",
      "url": "https://mcp.refract.social"
    }
  }
}
```

## Tools

- `create-draft`: Creates a draft post with text, accounts and optional media
- `delete-draft`: Deletes a draft or a post awaiting approval
- `upload-media`: Adds an image or video to the media library
- `request-media-upload`: Gives a one-time upload link for a file
- `update-draft`: Changes a post that has not gone out
- `check-post`: Runs the composer's checks and lists issues per platform
- `find-slots`: Finds the next free posting times
- `send-for-approval`: Sends a draft to the team for approval
- `schedule-post`: Schedules a draft
- `publish-now`: Publishes a draft or scheduled post now
- `reschedule-post`: Moves a scheduled post to a new time
- `unschedule-post`: Returns a scheduled post to drafts
- `list-workspaces`: Lists workspaces this connection can use
- `list-accounts`: Lists connected social accounts in a workspace
- `list-posts`: Lists a workspace's posts, newest first
- `get-post`: Gets one post with its status and history

## FAQ

### How does it authenticate?

OAuth 2.1 sign-in with your Refract account; no token to paste.

### Can an assistant publish without approval?

Only at the Schedule and publish level, and workspaces can require agent posts to wait for approval.

### Is there a free trial?

Yes, 14 days with every feature and no card.

### How many tools are there?

The site lists 20 tools, and an app only gets those its level allows.

### Is Refract free?

Refract is a paid product with a free trial. Paid plans start at $10 a month.

### How do I add Refract to Claude Code?

Run this command in your terminal: claude mcp add --transport http refract https://mcp.refract.social

### What are the best alternatives to Refract?

The closest alternatives to Refract are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/refract-2
