# OmniSocials MCP Server

> Manage social media from Claude, ChatGPT, Cursor, or any MCP-compatible client. Schedule and publish posts, stories, and reels across 11 platforms, read analytics, and reply to your social inbox, all through natural conversation.

This is the machine-readable version of [omnisocials.com/mcp](https://omnisocials.com/mcp). Structured discovery: [omnisocials.com/.well-known/mcp.json](https://omnisocials.com/.well-known/mcp.json).

## Connection

- Remote server (streamable HTTP): `https://mcp.omnisocials.com`
- Local server (stdio): `npx -y @omnisocials/mcp-server` with env var `OMNISOCIALS_API_KEY`
- npm package: [@omnisocials/mcp-server](https://www.npmjs.com/package/@omnisocials/mcp-server)

Authentication, two options:

1. **OAuth**: remote clients like Claude (web and desktop) connect to `https://mcp.omnisocials.com` and sign in with an OmniSocials account.
2. **API key**: pass it as a query parameter, `https://mcp.omnisocials.com?API_KEY=omsk_live_your_key`, or as the `OMNISOCIALS_API_KEY` env var for the local server. Create keys at [app.omnisocials.com/settings/api](https://app.omnisocials.com/settings/api). Inbox access requires the opt-in `inbox:read` / `inbox:write` scopes, analytics requires `analytics:read`.

## Client setup

| Client | Setup |
| --- | --- |
| Claude (web/desktop) | Settings -> Connectors -> Add custom connector -> `https://mcp.omnisocials.com`, then sign in |
| Claude Code | `claude mcp add omnisocials -- npx -y @omnisocials/mcp-server` |
| ChatGPT | Settings -> MCP Tools -> Add -> `https://mcp.omnisocials.com?API_KEY=your_key` |
| Cursor | Create `.cursor/mcp.json` with the JSON config below |
| Windsurf | Add the JSON config below to `~/.codeium/windsurf/mcp_config.json` |
| OpenClaw | `{ "omnisocials": { "type": "url", "url": "https://mcp.omnisocials.com?API_KEY=your_key" } }` |
| Hermes | `mcp_servers: { omnisocials: { url: "https://mcp.omnisocials.com?API_KEY=your_key" } }` |

JSON config for Cursor, Windsurf, and other file-configured clients:

```json
{
  "mcpServers": {
    "omnisocials": {
      "command": "npx",
      "args": ["-y", "@omnisocials/mcp-server"],
      "env": {
        "OMNISOCIALS_API_KEY": "omsk_live_your_key"
      }
    }
  }
}
```

## Tools

Workspaces and accounts:

- `list_workspaces`: list all workspaces the user has access to
- `switch_workspace`: switch the active workspace by name or id
- `list_accounts`: list connected social accounts for the active workspace
- `get_account`: details for one connected account (includes Pinterest boards)

Posts:

- `create_post`: create a post, story, or reel as draft or scheduled, with per-platform options
- `create_and_publish_post`: create and publish immediately
- `update_post`: update a draft or scheduled post
- `publish_post`: publish a draft or scheduled post now
- `delete_post`: delete a post
- `get_post`: full post details including per-platform variants and published URLs
- `list_posts`: list posts filtered by status (draft, scheduled, published, failed)
- `get_calendar`: content calendar by day
- `get_recent_platform_posts`: fetch recent posts live from the connected platform APIs, including content posted outside OmniSocials

Media and folders:

- `upload_media`: upload via URL, base64, or presigned upload URL (up to 100 MB per file, 1 GB via URL, PDFs become carousels)
- `list_media`, `update_media`, `delete_media`: manage the media library
- `check_media_compatibility`: pre-check whether a file is accepted by connected platforms
- `create_folder`, `list_folders`: organize the media library

Hashtag sets:

- `create_hashtag_set`, `list_hashtag_sets`, `update_hashtag_set`, `delete_hashtag_set`: named reusable hashtag groups

Discovery:

- `search_locations`: find taggable Instagram/Facebook locations
- `search_instagram_audio`: search licensed or trending Instagram audio for Reels

Analytics:

- `get_analytics_overview`: impressions, engagements, and per-platform breakdowns over 7, 30, or 90 days
- `get_post_analytics`, `get_posts_analytics`: metrics for one post or up to 100 posts at once
- `get_account_analytics`: follower and engagement metrics per account
- `get_best_times`: recommended posting slots per platform

Social inbox:

- `list_inbox_conversations`: DM, comment, and mention conversations across platforms
- `get_inbox_conversation`: full message history for one conversation
- `reply_to_inbox`: reply to a conversation
- `mark_inbox_read`: mark a conversation as read

Webhooks:

- `create_webhook`, `list_webhooks`, `get_webhook`, `update_webhook`, `delete_webhook`, `rotate_webhook_secret`: webhooks for `post.scheduled`, `post.published`, and `post.failed` events with signed payloads

## Platforms

Instagram, Facebook, LinkedIn (Profile and Page), YouTube, TikTok, X, Pinterest, Threads, Bluesky, Mastodon, and Google Business. Reddit and Snapchat are coming soon.

## Pricing

The MCP server is included in every plan at no extra cost. OmniSocials is $10 per workspace per month billed annually with a 14-day free trial. Details: [omnisocials.com/pricing.md](https://omnisocials.com/pricing.md)

## More

- [llms.txt](https://omnisocials.com/llms.txt)
- [CLI and agent skills](https://omnisocials.com/cli.md)
- [REST API](https://omnisocials.com/api.md)
- [Developer docs](https://docs.omnisocials.com/llms.txt)