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.
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:
"Set up my Dev.to API key: dv1_abc123..."
"Score this article for SEO targeting 'MCP servers'"
"Generate meta tags and JSON-LD for this article"
"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.
SEO Tools
Analyze, score, and optimize your content for search engines.
seo_scorefreeSEO 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | The markdown content to analyze |
keyword | string | Yes | Target keyword to check density for |
seo_metastarterSEO 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | The content to generate meta tags for |
keyword | string | Yes | Target keyword for optimization |
seo_schemastarterJSON-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.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | The content to generate schema for |
type | string | Yes | Schema type: article, howto, faq, or software |
Publishing
Publish and manage content across platforms.
publishfreePublish
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Markdown content to publish |
title | string | Yes | Article title |
platform | string | Yes | Target platform (devto) |
tags | string[] | No | Up to 4 tags for the article |
status | string | No | draft or published (default: draft) |
canonical_url | string | No | Canonical URL if cross-posting |
series | string | No | Series name to group articles |
list_postsproList 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | Platform to list posts from (devto) |
status | string | No | Filter: all, published, or draft (default: all) |
Account
Configure platforms, manage your license, and check status.
setupfreeSetup
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | Platform to configure (devto) |
api_key | string | Yes | Your platform API key |
activatefreeActivate
Activate a Starter or Pro license key. Validates with Lemon Squeezy and caches locally for offline use. Re-validates every 24 hours when online.
| Parameter | Type | Required | Description |
|---|---|---|---|
license_key | string | Yes | Your license key from checkout |
statusfreeStatus
Show your current Pipepost configuration: version, license tier, configured platforms, API key status, and monthly usage stats.
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.