|> Pipepost

Publish from your terminal.

MCP server that turns Claude Code into a complete content publishing pipeline — SEO, multi-platform publishing, social promotion, and analytics.

Website · Docs · npm

---

See it in one chat turn

→ Real agent-loop transcript — Claude Code takes a draft, audits it, scores SEO, fixes issues, cross-publishes to 5 CMS platforms with canonical URL wiring, generates social promo posts for Twitter/LinkedIn/Bluesky, and submits to IndexNow. One prompt. ~90 seconds. 2 credits.

Why Pipepost?

Task	Without Pipepost	With Pipepost
Publish to Dev.to	Copy-paste into browser, format, add tags, submit	"Publish this to Dev.to as a draft"
Cross-post to 5 platforms	Repeat the above five times	"Cross-publish to all platforms"
SEO optimization	Switch between 3 tools, copy results back	"Score this for SEO targeting 'mcp servers'"
Social promotion	Write separate posts for each network	"Generate social posts for Twitter, LinkedIn, and Reddit"
Cover images	Browse Unsplash, download, upload, add attribution	"Find a cover image for this article"
Search indexing	Wait days for crawlers to find your content	"Submit this URL to IndexNow"
Content analytics	Log into 5 dashboards, compare manually	"Show my analytics across all platforms"
Pre-publish QA	Manually check links, readability, structure	"Audit this article and check all links"
Draft management	Copy between editors, lose track of versions	"Save this as a draft targeting Dev.to and Ghost"
Canonical URLs	Manually set on each platform after cross-posting	Automatic — first platform URL wired to all others

Quick Start

npx pipepost-mcp init

Add Pipepost to your Claude Code config (~/.claude/settings.json):

{
  "mcpServers": {
    "pipepost": {
      "command": "npx",
      "args": ["-y", "pipepost-mcp"]
    }
  }
}

That's it. Try asking Claude:

Score this article for SEO targeting 'mcp servers'

Tools

SEO (4 tools)

Tool	Description	Cost
seo_score	Analyze content for readability, keyword density, and heading structure	Free (basic) / Credits (full)
seo_meta	Generate meta title, description, and Open Graph tags	Credits
seo_schema	Generate JSON-LD structured data (Article, FAQ, HowTo)	Credits
index_now	Submit URLs to search engines for instant indexing via IndexNow	Free

Publishing (3 tools)

Tool	Description	Cost
publish	Publish to Dev.to, Ghost, Hashnode, WordPress, Medium, or Substack	1 credit
cross_publish	Publish to multiple platforms with automatic canonical URL wiring	1 credit
list_posts	List published and draft posts from any platform	Free

Drafts (4 tools)

Tool	Description	Cost
save_draft	Save content as a local draft for later publishing	Free
list_drafts	List all saved drafts with status, platforms, and dates	Free
get_draft	Retrieve a saved draft by ID	Free
delete_draft	Delete a saved draft by ID	Free

Content Quality (2 tools)

Tool	Description	Cost
content_audit	Audit markdown for quality issues — readability, structure, heading hierarchy	Free (basic) / Credits (full)
check_links	Validate all URLs in markdown — reports broken, redirected, and timed-out links	Free

Content Repurposing (2 tools)

Tool	Description	Cost
generate_social_posts	Generate platform-optimized posts for Twitter, LinkedIn, Reddit, Bluesky	Credits
repurpose	Transform a blog post into Twitter threads, LinkedIn posts, Reddit posts, HN titles, Bluesky posts, newsletter intros	Credits

Broadcast (4 tools)

Tool	Description	Cost
bluesky_post	Post directly to Bluesky as a single post or a threaded series. Bare URLs auto-linkified	Free
mastodon_post	Post directly to any Mastodon instance as a single post or a threaded series	Free
linkedin_post	Post to LinkedIn (personal). Person URN resolved automatically on first use and cached	Free
x_post	Post to X as a single tweet or reply-chained thread. OAuth 1.0a HMAC-SHA1 signing built in	Free

Listening & Reply (4 tools)

Tool	Description	Cost
bluesky_mentions	List notifications addressed to the configured account — mentions and replies by default	Free
bluesky_search	Search public Bluesky posts by keyword, author, mentions, tag, or language. No auth needed	Free
bluesky_thread	Fetch the full conversation around a post — parents above, replies below, for reply context	Free
bluesky_reply	Reply to a Bluesky post (single reply or chained thread) — root + parent refs computed automatically	Free

Images (1 tool)

Tool	Description	Cost
cover_image	Search Unsplash for cover images with proper attribution	Free

Content (1 tool)

Tool	Description	Cost
frontmatter	Generate frontmatter for Hugo, Jekyll, Astro, Next.js, Dev.to, Hashnode, Ghost	Free

Analytics (1 tool)

Tool	Description	Cost
analytics	Fetch post views, reactions, and comments across all configured platforms	Free

Account (3 tools)

Tool	Description	Cost
setup	Configure API credentials for any platform	Free
activate	Activate a credit pack license key	Free
status	Show current configuration and credit balance	Free

How It Works

1. Install -- add the MCP server to Claude Code with npx pipepost-mcp init
2. Configure -- use the setup tool to store your platform API keys locally
3. Create -- write content in Claude Code, then use SEO tools to optimize it
4. Publish -- publish to any platform with natural language, then promote with generated social posts

Pricing

	Free	Starter ($8)	Pro ($19)	Power ($49)
Credits	3/month	10	30	100
SEO scoring	Basic	Full analysis	Full analysis	Full analysis
SEO meta + schema	--	✔	✔	✔
Publish	✔	✔	✔	✔
Cross-publish	✔	✔	✔	✔
Social generation	--	✔	✔	✔
Repurpose	--	✔	✔	✔

3 free credits every month. Purchased credits never expire.

Tip

Cross-publishing to 5 platforms costs just 1 credit. Publishing + social generation for a single article costs 2 credits total.

Platform Support

CMS Platforms

Platform	Publish	List Posts	Analytics	Featured Images
Dev.to	✔	✔	✔	✔
Ghost	✔	✔	✔	✔
Hashnode	✔	✔	✔	✔
WordPress	✔	✔	✔	✘
Medium	✔	✘	✘	✔
Substack	✔	✔	✘	✘

Social Platforms (Generation)

Platform	Format
Twitter/X	Threads with hook, key points, and CTA
LinkedIn	Professional long-form posts
Reddit	Post with title, body, and suggested subreddits
Bluesky	Short-form posts within character limits
Hacker News	Optimized submission titles
Newsletter	Intro paragraphs for email digests

Frontmatter Formats

Hugo, Jekyll, Astro, Next.js, Dev.to, Hashnode, Ghost -- auto-extracts description, reading time, slug, and tags from your content.

Privacy & Security

Note

Pipepost runs as a local stdio process. Your API keys are stored in ~/.pipepost/config.json and never leave your machine. No cloud server, no telemetry, no data collection.

Architecture

Claude Code
    |
    | stdio
    v
Pipepost MCP Server
    |
    |--- SEO Engine (local scoring, meta generation, JSON-LD)
    |--- IndexNow API (Bing, Yandex, search engines)
    |--- Unsplash API (cover images)
    |--- Dev.to / Ghost / Hashnode / WordPress / Medium / Substack APIs
    |--- Bluesky AT Protocol (post, search, reply)
    |--- Mastodon API (any instance)
    |--- LinkedIn /v2/ugcPosts
    |--- X v2 /tweets (OAuth 1.0a)

All processing happens locally. Platform APIs are only called when you explicitly publish, fetch analytics, or search for images.

API Key Setup

Platform	Where to get your key
Dev.to	dev.to/settings/extensions
Ghost	Ghost Admin > Settings > Integrations > Custom
Hashnode	hashnode.com/settings/developer
WordPress	Users > Application Passwords
Medium	medium.com/me/settings/security
Substack	DevTools → Application → Cookies → substack.com → copy connect.sid. Pass with your publication URL (e.g. https://you.substack.com).
Unsplash	unsplash.com/developers
Bluesky	bsky.app/settings/app-passwords
Mastodon	https://<your-instance>/settings/applications (scope: write:statuses)
LinkedIn	linkedin.com/developers/apps (scopes: openid, profile, w_member_social). Run pnpm linkedin:auth for the 3-legged flow.
X	developer.x.com — OAuth 1.0a app with read+write

Contributing

git clone https://github.com/MendleM/Pipepost.git
cd Pipepost
pnpm install
pnpm test
pnpm build

Run in development mode with file watching:

pnpm dev

License

MIT