@postforme/mcp

MCP server for PostForMe — social media content automation tools for Claude Code.

Installation

npx -y @postforme/mcp@latest

Or add to your .mcp.json:

{
  "mcpServers": {
    "postforme": {
      "command": "npx",
      "args": ["-y", "@postforme/mcp@latest"],
      "env": {
        "POSTFORME_API_KEY": "YOUR_API_KEY",
        "POSTFORME_API_URL": "http://localhost:4002/api/postforme"
      }
    }
  }
}

Setup

1. Log in to PostForMe at http://localhost:3000
2. Go to Settings > Claude Code
3. Generate an API key
4. Copy the .mcp.json config shown
5. Restart Claude Code

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | POSTFORME_API_KEY | Yes | Your PostForMe API key (starts with pfm_) | | POSTFORME_API_URL | Yes | PostForMe API endpoint (default: http://localhost:4002/api/postforme) | | POSTFORME_RENDER_PATH | No | Absolute path to postforme-render/ project for video rendering |

Tools

| Tool | Description | |------|-------------| | list_assets | List media assets in your library | | get_asset | Get asset details and analysis | | download_asset | Download asset to local disk | | get_brand | Get brand profile (colors, voice, hashtags) | | list_content | List content items | | get_content | Get content details | | create_content | Create content from an asset | | update_content | Update captions, status, or analysis | | render_video | Render branded video via Remotion (requires POSTFORME_RENDER_PATH) | | upload_render | Upload a pre-rendered video | | list_renders | List renders for a content item | | poll_messages | Poll for user messages from the web UI | | send_message | Send a reply to the user in the web UI | | get_meta_status | Check Meta (Instagram/Facebook) connection | | publish_meta | Publish approved content to Instagram/Facebook |

Video Rendering

To enable video rendering, set POSTFORME_RENDER_PATH to the absolute path of your postforme-render project:

{
  "env": {
    "POSTFORME_RENDER_PATH": "/path/to/postforme-render"
  }
}

Rendering also requires Remotion and ffprobe to be installed in the render project.

License

MIT