English Français العربية

Postbase

السجل الرسمي التسويق والمبيعات

Schedule social posts, threads and video to X, LinkedIn, Bluesky, Mastodon and YouTube from your AI.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http postbase 'https://mcp.postbase.so/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "postbase": {
            "type": "http",
            "url": "https://mcp.postbase.so/mcp"
        }
    }
}
NPM package @postbasehq/mcp
Claude Code 
claude mcp add postbase -e 'POSTBASE_API_KEY=<your postbase_api_key>' -e 'POSTBASE_API_URL=<POSTBASE_API_URL>' -- npx -y @postbasehq/mcp@0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "postbase": {
            "command": "npx",
            "args": [
                "-y",
                "@postbasehq/mcp@0.3.0"
            ],
            "env": {
                "POSTBASE_API_KEY": "<your postbase_api_key>",
                "POSTBASE_API_URL": "<POSTBASE_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • POSTBASE_API_KEY إلزامي سري API key from Postbase → Developers
  • POSTBASE_API_URL API base URL, for self-hosted instances (default https://www.postbase.so/api/v1)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @postbasehq/mcp
  2. Hosted server (no API key)
  3. Quick start
  4. Example configs
  5. Tools
  6. Environment
  7. License

@postbasehq/mcp

The Model Context Protocol server for Postbase, the open-source social media scheduler. Add it to Claude, Cursor or any MCP client and let your AI agent draft and schedule posts and threads to X, LinkedIn, Bluesky and Mastodon. (TikTok and YouTube need a video, so schedule those in the app.)

Post everywhere. Even from your AI.

Hosted server (no API key)

Postbase also runs this server for you at https://mcp.postbase.so/mcp, with OAuth sign-in instead of an API key. Add that URL as a custom connector in Claude or ChatGPT, or as a remote MCP server in Cursor, VS Code, Windsurf, Claude Code or Gemini CLI. The MCP config generator prints the exact setup for each one.

Use this npm package when you want an API key instead, or a self-hosted Postbase.

Quick start

  1. Create an API key in your Postbase dashboard under Developers.
  2. Add the server to your MCP client config (see examples below).
  3. Ask your agent: "Schedule this thread for 9am to X and Bluesky."

Example configs

Any MCP client — the minimal config:

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

Claude Desktop — add the same block to your config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Then restart Claude Desktop.

Cursor — add it to ~/.cursor/mcp.json (or Settings → MCP):

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

Local development — point at a Postbase instance running on your machine:

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": {
        "POSTBASE_API_KEY": "pb_live_your_key_here",
        "POSTBASE_API_URL": "http://localhost:3000/api/v1"
      }
    }
  }
}

Tools

ToolWhat it does
list_channelsList the channels connected to your workspace.
create_postCreate a draft, or schedule a post or thread: channel_ids, scheduled_at (ISO 8601 with an offset) or schedule_in_minutes, channel_bodies for per-channel text, media_ids or media_urls, youtube details, and an idempotency_key so retries can't post twice. TikTok posts can only be drafts.
get_postHow a post went on each channel: status, live URL, error, retry time and latest metrics.
update_postEdit or reschedule a draft or scheduled post; only the fields you pass change.
retry_postSend a post again to the channels where it failed.
get_analyticsImpressions, likes, comments, shares and saves per post and channel, with totals.
list_mediaList images and videos in your Postbase media library, to attach by id.
add_mediaAdd an image or video to the media library from a public https link.
list_scheduledList scheduled posts, or drafts, published or failed ones with status.
cancel_postCancel a scheduled post by id (it goes back to a draft).
schedule_threadCreate a thread (tweets in order). Kept for older setups; create_post with thread does the same.

Environment

VariableRequiredDefault
POSTBASE_API_KEYyes—
POSTBASE_API_URLnohttps://www.postbase.so/api/v1

For local development against a Postbase instance on your machine, set POSTBASE_API_URL=http://localhost:3000/api/v1.

License

AGPL-3.0-or-later. Part of the open-source Postbase project.

الأسئلة الشائعة

ما هو Postbase؟

Schedule social posts, threads and video to X, LinkedIn, Bluesky, Mastodon and YouTube from your AI.

كيف أثبّت Postbase؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http postbase 'https://mcp.postbase.so/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Postbase إلى مفتاح API؟

نعم. يتطلب POSTBASE_API_KEY، وتضبطها في إعداداته.

هل Postbase مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص AGPL-3.0.

من يصون Postbase؟

ينشره postbasehq. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.