mcp
MCP server for Postbase: let Claude, Cursor or any MCP client schedule posts and threads to X, LinkedIn, Bluesky and Mastodon.
Install / Use
claude mcp add postbasehq -- npx -y github:postbasehq/mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of mcp
mcp scores 76/100 on our quality scale, 609th of 642 Marketing skills we index.
Its MCP Server is 4.3 KB long, split into 7 sections with 3 code examples: a solid amount of guidance for an agent.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 37 days ago, so mcp is actively maintained.
- Our last check on 2026-11-10 found the source still online.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
mcp compared with similar skills
All 4 of these similar skills score higher than mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp (this skill)by postbasehq | 76 | 10 | 37d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install mcp?
- Run
claude mcp add postbasehq -- npx -y github:postbasehq/mcp. The install tabs above show the steps for each supported agent. - Which AI agents does mcp work with?
- It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mcp still maintained?
- The repository was last updated 37 days ago, so mcp is actively maintained.
Skill content
View source on GitHub@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
- Create an API key in your Postbase dashboard under Developers.
- Add the server to your MCP client config (see examples below).
- 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_l…[redacted]" }
}
}
}
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_l…[redacted]" }
}
}
}
Local development — point at a Postbase instance running on your machine:
{
"mcpServers": {
"postbase": {
"command": "npx",
"args": ["@postbasehq/mcp"],
"env": {
"POSTBASE_API_KEY": "pb_l…[redacted]",
"POSTBASE_API_URL": "http://localhost:3000/api/v1"
}
}
}
}
Tools
| Tool | What it does |
|---|---|
| list_channels | List the channels connected to your workspace. |
| create_post | Create 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_post | How a post went on each channel: status, live URL, error, retry time and latest metrics. |
| update_post | Edit or reschedule a draft or scheduled post; only the fields you pass change. |
| retry_post | Send a post again to the channels where it failed. |
| get_analytics | Impressions, likes, comments, shares and saves per post and channel, with totals. |
| list_media | List images and videos in your Postbase media library, to attach by id. |
| add_media | Add an image or video to the media library from a public https link. |
| list_scheduled | List scheduled posts, or drafts, published or failed ones with status. |
| cancel_post | Cancel a scheduled post by id (it goes back to a draft). |
| schedule_thread | Create a thread (tweets in order). Kept for older setups; create_post with thread does the same. |
Environment
| Variable | Required | Default |
|---|---|---|
| POSTBASE_API_KEY | yes | — |
| POSTBASE_API_URL | no | https://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.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
