Examples

OpenClaw

Post this update to LinkedIn and Bluesky tomorrow at 9am. Validate first, show warnings, then schedule if safe.

Claude Desktop

{
  "mcpServers": {
    "postmcp": {
      "command": "postmcp-mcp",
      "env": {
        "POSTMCP_API_KEY": "${POSTMCP_API_KEY}"
      }
    }
  }
}

Claude Code

postmcp post create --text "Shipped the API docs" --to bluesky:acct_123 --dry-run --json

Cursor

{
  "mcpServers": {
    "postmcp": {
      "command": "postmcp-mcp",
      "env": {
        "POSTMCP_API_KEY": "${POSTMCP_API_KEY}"
      }
    }
  }
}

Codex

postmcp post schedule --text "Nightly build passed" --to x:acct_x --schedule "2026-05-14T13:00:00.000Z" --dry-run --json

GitHub Actions

name: publish-release-post
on:
  release:
    types: [published]
jobs:
  post:
    runs-on: ubuntu-latest
    steps:
      - run: npx postmcp post create --text "Release shipped: ${{ github.ref_name }}" --to bluesky:${{ secrets.POSTMCP_BLUESKY_ACCOUNT }} --json
        env:
          POSTMCP_WORKSPACE_ID: ${{ secrets.POSTMCP_WORKSPACE_ID }}
          POSTMCP_API_KEY: ${{ secrets.POSTMCP_API_KEY }}

n8n

{
  "method": "POST",
  "url": "https://api.postmcp.dev/posts",
  "headers": {
    "authorization": "Bearer {{$env.POSTMCP_API_KEY}}"
  },
  "body": {
    "workspace_id": "wrk_123",
    "created_by_type": "agent",
    "created_by_id": "n8n",
    "text": "Workflow completed",
    "targets": [{ "platform": "bluesky", "connected_account_id": "acct_123" }]
  }
}

Zapier

{
  "url": "https://api.postmcp.dev/posts",
  "method": "POST",
  "headers": {
    "authorization": "Bearer {{POSTMCP_API_KEY}}"
  },
  "body": {
    "workspace_id": "wrk_123",
    "created_by_type": "agent",
    "created_by_id": "zapier",
    "text": "{{trigger.summary}}",
    "targets": [{ "platform": "linkedin", "connected_account_id": "acct_123" }]
  }
}

cron jobs

0 13 * * 1 POSTMCP_WORKSPACE_ID=wrk_123 POSTMCP_API_KEY=pmcp_key_123 postmcp post schedule --text "Weekly update" --to linkedin:acct_123 --schedule "next monday 09:00" --json

Node SDK

import { createPostMcpApiClient } from "@postmcp/api-client";

const client = createPostMcpApiClient({
  baseUrl: "https://api.postmcp.dev",
  apiKey: process.env.POSTMCP_API_KEY!,
  fetch,
});

await client.createPost({
  workspace_id: "wrk_123",
  created_by_type: "agent",
  created_by_id: "node-sdk",
  text: "Node SDK post",
  targets: [{ platform: "bluesky", connected_account_id: "acct_123" }],
});

Python SDK

import os
import requests

requests.post(
    "https://api.postmcp.dev/posts",
    headers={"authorization": f"Bearer {os.environ['POSTMCP_API_KEY']}"},
    json={
        "workspace_id": "wrk_123",
        "created_by_type": "agent",
        "created_by_id": "python-sdk",
        "text": "Python SDK post",
        "targets": [{"platform": "bluesky", "connected_account_id": "acct_123"}],
    },
)