v0.1.2

Pipepost Docs

Everything you need to install, configure, and use Pipepost with Claude Code. One command to set up, natural language to use.

Installation

Run this in your terminal. It automatically installs the Pipepost MCP server, configures Claude Code to use it, and creates your local config file.

Manual setup: If you prefer, add pipepost-mcp to your Claude Code MCP server config in ~/.claude/settings.json under the mcpServers key.

Quick start

Once installed, use Pipepost tools through natural language in Claude Code. Here's the typical workflow:

1Connect a platform

"Set up my Dev.to API key: dv1_abc123..."

2Score your content

"Score this article for SEO targeting 'MCP servers'"

3Optimize metadata

"Generate meta tags and JSON-LD for this article"

4Publish

"Publish this to Dev.to as a draft with tags: node, cli"

Configuration

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

~/.pipepost/config.json
{
"platforms": {
"devto": { "api_key": "dv1_..." }
},
"license": { "key": "...", "tier": "pro" }
}

SEO Tools

Analyze, score, and optimize your content for search engines.

seo_scorefree

SEO Score

Analyze your content for SEO quality. Returns a composite 0–100 score based on readability (sentence length, passive voice, paragraph density), keyword usage (density, placement in headings), heading structure (hierarchy, count), and word count. Includes specific improvement tips.

ParameterTypeDescription
contentstringThe markdown content to analyze
keywordstringTarget keyword to check density for
claude code
you: "Score my article about building MCP servers for SEO"
SEO Score: 84/100 — Readability: Grade 8, Keywords: 2.1%, Headings: clean hierarchy
seo_metastarter

SEO Meta Tags

Generate optimized meta titles, descriptions, and Open Graph tags for your content. Follows Google’s recommended character limits (title ≤60 chars, description ≤155 chars). Returns ready-to-use HTML meta tags.

ParameterTypeDescription
contentstringThe content to generate meta tags for
keywordstringTarget keyword for optimization
claude code
you: "Generate meta tags for this article targeting 'node cli tools'"
Meta title (54ch), description (148ch), OG title, OG description, OG type
seo_schemastarter

JSON-LD Schema

Generate structured data markup (JSON-LD) for your content. Supports Article, HowTo, FAQPage, and SoftwareApplication schemas. Output is a complete JSON-LD script tag ready to embed.

ParameterTypeDescription
contentstringThe content to generate schema for
typestringSchema type: article, howto, faq, or software
claude code
you: "Generate Article JSON-LD schema for this blog post"
Complete JSON-LD script tag ready to embed in your page

Publishing

Publish and manage content across platforms.

publishfree

Publish

Publish your content to Dev.to (more platforms coming). Supports drafts and published states, tags, canonical URLs, series grouping, and cover images. Free tier includes 3 publishes per month.

ParameterTypeDescription
contentstringMarkdown content to publish
titlestringArticle title
platformstringTarget platform (devto)
tagsstring[]Up to 4 tags for the article
statusstringdraft or published (default: draft)
canonical_urlstringCanonical URL if cross-posting
seriesstringSeries name to group articles
claude code
you: "Publish this article to Dev.to as a draft with tags: node, cli, javascript"
Published to dev.to/you/article-slug — 1,247 words, 6 min read
list_postspro

List Posts

List your published and draft posts on a platform. Shows title, status, publish date, URL, and basic stats. Filter by status to find drafts or published articles.

ParameterTypeDescription
platformstringPlatform to list posts from (devto)
statusstringFilter: all, published, or draft (default: all)
claude code
you: "Show me my draft posts on Dev.to"
3 drafts found — Building CLI Tools (Apr 12), MCP Guide (Apr 10), …

Account

Configure platforms, manage your license, and check status.

setupfree

Setup

Configure platform API keys. Keys are stored locally in ~/.pipepost/config.json and never leave your machine. Run this once per platform to connect it.

ParameterTypeDescription
platformstringPlatform to configure (devto)
api_keystringYour platform API key
claude code
you: "Set up my Dev.to API key: dv1_abc123…"
Dev.to API key saved to ~/.pipepost/config.json
activatefree

Activate

Activate a Starter or Pro license key. Validates with Lemon Squeezy and caches locally for offline use. Re-validates every 24 hours when online.

ParameterTypeDescription
license_keystringYour license key from checkout
claude code
you: "Activate my Pipepost license: XXXX-XXXX-XXXX"
Pro license activated. Cached for offline use (re-validates every 24h).
statusfree

Status

Show your current Pipepost configuration: version, license tier, configured platforms, API key status, and monthly usage stats.

claude code
you: "Show my Pipepost status"
v0.1.2 — Free tier, Dev.to configured, 1/3 publishes used this month

Ready to try these tools?

Free tier includes seo_score, publish (3/mo), setup, activate, and status. Upgrade for the full SEO suite and all platforms.

View pricing