Planoly MCP Server

Connect AI assistants to Planoly — plan, create, schedule, and analyze social media content across Instagram, TikTok, YouTube, Pinterest, Facebook, and more, straight from Claude, Cursor, or any MCP client.

This is a remote MCP server, hosted by Planoly:

https://mcp.planoly.com/mcp

There is nothing to install or run — you connect your MCP client to the URL above and sign in with your Planoly account via OAuth. This repository hosts the public documentation and registry metadata for the server.

What you can do

• Create and schedule posts across all your connected channels in one call — shared caption/media with per-platform overrides, Instagram tags and collaborators, TikTok sounds and privacy settings, YouTube visibility, Pinterest boards, and more.
• Manage your content calendar — list drafts and scheduled posts, edit captions and settings, reschedule (including Instagram Best Time slots), or delete.
• Work with your media library — browse, search, organize into folders, preview media, import from URLs, or upload new assets.
• Analyze performance — Instagram account analytics, per-post performance ranked by the metric you care about, public account research via Business Discovery, and shareable report links.
• Discover trends — browse TikTok's Commercial Music Library trending sounds and attach them to posts.

See docs/examples.md for example prompts and workflows.

Getting started

Claude Code

claude mcp add --transport http planoly https://mcp.planoly.com/mcp

Claude (claude.ai and Claude Desktop)

Go to Settings → Connectors → Add custom connector and enter:

https://mcp.planoly.com/mcp

Cursor

Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):

{
  "mcpServers": {
    "planoly": {
      "url": "https://mcp.planoly.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"planoly","type":"http","url":"https://mcp.planoly.com/mcp"}'

Other clients (stdio-only)

For clients that only support local stdio servers, bridge with `mcp-remote`:

{
  "mcpServers": {
    "planoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.planoly.com/mcp"]
    }
  }
}

On first use, your client opens a browser window to sign in to Planoly and approve access. If the bridge's auth state gets stuck, clear it with `rm -rf ~/.mcp-auth` and reconnect.

Authentication

The server uses the standard MCP authorization flow — OAuth 2.1 authorization code with refresh tokens, discovered automatically by the client:

• Protected resource metadata: `https://mcp.planoly.com/.well-known/oauth-protected-resource/mcp`
• Authorization server: `https://app.planoly.com/api/auth`
• Scopes: `openid`, `profile`, `email`, `offline_access`

Tokens are scoped to your Planoly user. Tools that operate on a workspace take a `workspaceId` and enforce workspace membership on every call — start with `list_workspaces` to see what you can access.

Full details in docs/authentication.md.

Tools

Summarized below; parameter-level detail lives in **docs/tools.md**.

Workspaces & channels

Posts & scheduling

Media library & assets

Analytics & research

Instagram tagging & TikTok sounds

How media gets into posts

The model never carries media bytes through inference. Media reaches a post by `assetId`, from one of three sources:

1. Existing media — take an `assetId` from `list_media_library` or from another post via `list_post_groups`.

2. From a URL — `create_asset_from_url` has the server fetch it (allowlisted hosts only).

3. Local bytes — `request_asset_upload` → HTTP `PUT` the bytes → `confirm_asset_upload`, for clients with a code-execution sandbox.

Details and constraints in docs/media.md.

Validation & plan requirements

Posts are validated against each platform's rules (caption length, media count/type, aspect ratio, video duration) the same way the Planoly app validates them — errors come back at tool-call time with the exact violation, not at publish time.

Some tools map to Planoly premium features and require a paid workspace: TikTok trending sounds, the media library tools, the analytics tools, and product tagging. When a tool requires an upgrade, the error includes a link to the billing page.

Documentation

• Tool reference — every tool, its parameters, and behavior
• Authentication — the OAuth flow, token model, resetting auth state
• Media handling — how assets get in and out
• Example prompts — workflows to try
• Troubleshooting — common errors and fixes
• Changelog

Support & security

• Product and account help: Planoly help center · see SUPPORT.md
• MCP server bugs and feature requests: issues
• Vulnerabilities: report privately per SECURITY.md

The server implementation is not open source; this repository tracks the public documentation and MCP registry metadata (server.json) for the hosted service.