Documentation

MCP Setup Guide

Connect PostMoore to Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client. One config block and you're posting from your AI assistant.

Before you start

Prerequisites

A PostMoore account — sign up free
At least one connected social media account
An API key from Profile → API Keys (Creator or Premium plan)
Node.js 18 or later installed on your machine

Claude Desktop

Setup for Claude Desktop

Easiest

Open your Claude Desktop config file. On macOS it lives at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json.

Add the postmore entry under mcpServers:

claude_desktop_config.json

{
  "mcpServers": {
    "postmore": {
      "command": "npx",
      "args": ["-y", "postmore-mcp"],
      "env": {
        "POSTMORE_API_KEY": "pm_live_your_api_key_here"
      }
    }
  }
}

Replace pm_live_your_api_key_here with your actual key. Save the file and restart Claude Desktop — PostMoore will appear in the tools panel.

Claude Code

Setup for Claude Code

Add PostMoore to your Claude Code MCP config at ~/.claude/settings.json:

~/.claude/settings.json

{
  "mcpServers": {
    "postmore": {
      "command": "npx",
      "args": ["-y", "postmore-mcp"],
      "env": {
        "POSTMORE_API_KEY": "pm_live_your_api_key_here"
      }
    }
  }
}

Once saved, run claude mcp list in your terminal to confirm PostMoore is registered.

Other clients

Setup for Cursor, Windsurf & others

Any MCP client that supports stdio transport can use the same npx command. Add it to your client's MCP server config — the exact file path varies by app.

Generic MCP client config

{
  "mcpServers": {
    "postmore": {
      "command": "npx",
      "args": ["-y", "postmore-mcp"],
      "env": {
        "POSTMORE_API_KEY": "pm_live_your_api_key_here"
      }
    }
  }
}

On first run, npx downloads and caches the package automatically. Node.js 18+ is required.

Tool reference

Tool Reference

The server exposes 7 tools. Your AI discovers them automatically — just instruct it in plain language.

ToolDescriptionKey params

list_accountsList all connected social accounts with IDs, platforms, and usernames.platform?

get_accountGet details of a specific connected account by its ID.id

create_postCreate and publish or schedule a post. Omit schedule or use schedule.type "now" to publish immediately, use "draft" to save without publishing, or use "scheduled" with schedule.at for a future time.contentType, accounts, schedule, text?, media?, caption?

list_postsList your posts. Optionally filter by status and paginate.status?, page?, limit?

get_postGet full details of a single post by ID.id

delete_postDelete a pending or draft post. Published and scheduled posts cannot be deleted.id

upload_mediaUpload a local image or video file. Returns an ID and URL to reference in create_post. Stdio mode only.filePath

Notes

Good to know

Drafts

Setting schedule.type to "draft" saves the post in PostMoore only. It does not create a native draft on any social platform. When you publish later, all platforms post immediately.

Media uploads

upload_media reads a file from your local machine, so it only works in stdio mode (npx postmore-mcp). Pass a public URL directly in the media array of create_post when running in other environments.

Deleting posts

You can only delete pending or draft posts. Scheduled and published posts cannot be deleted via the MCP tools.

Account IDs

Run list_accounts first to get the account IDs you need for create_post. Your AI will do this automatically if you ask it to post to a named platform.

Access

Managing access

View, rotate, and revoke API keys any time from Profile → API Keys. Revoking a key immediately disconnects any client using it. Each key is scoped to your account — do not share keys across team members.

READY TO CONNECT?

Get your API key and add PostMoore to your assistant in under a minute.

→ Get API Key Back to MCP