Guide — PublishMCP

Publishing articles

Tell Claude what to write and where to publish it. Articles are saved to your PublishMCP account instantly and your site can fetch them via the JSON API.

Write and publish an article about how to speed up a WordPress site for mysite.com

Claude writes the article, picks a slug, and calls publish_article. Saved to your account instantly, domain set to mysite.com.

Write an article about X, generate an article image, and publish it

Claude writes the article, generates an image via OpenRouter, uploads it, and includes the URL — all in one conversation.

Publish this as a draft, I want to review it first

Pass published=false. Article is saved but won't appear on your site or newsorwhat.com until you publish it.

Write 3 articles targeting these search queries: [paste queries]

Claude writes and publishes all three in sequence. Useful after running search_console_top_queries to find article topics.

Publish this article for shopmcp.net, category Guides, tags: shopify claude, mcp

Specify domain, category and tags in one instruction. Claude passes all fields to publish_article.

Write an article in the same style as my previous one — get_article slug=my-last-article

Claude reads your existing article first, matches the tone and structure, then writes the new one. Keeps content consistent across your site.

Multiple sites? Always tell Claude which domain to publish for: "publish this for mysite.com". Claude passes the domain parameter and your site's API call filters by it automatically.

Managing articles

List, read, edit and delete articles without touching the dashboard. Claude handles it all in conversation.

List all my published articles

Returns all articles with slug, title, category, domain and date. Use this to find slugs before editing.

List my articles for shopmcp.net

Filtered by domain — useful when you publish to multiple sites from the same account.

Read the article with slug my-article and add a section about X

Claude calls get_article to read the full content, rewrites it with the new section, then calls update_article.

Update the title and summary of my-article-slug

update_article only updates the fields you specify — everything else stays unchanged.

Unpublish my-article-slug

Sets published=false. Article disappears from your site and newsorwhat.com immediately.

Fix the SEO tags on all my articles for mysite.com

Claude lists all articles, reads each one, rewrites the tags for SEO, and updates them. Works best with a few articles at a time.

Article images

Generate AI article images or upload your own. Images are stored on our CDN and linked to the article by URL.

Generate an article image for this article — cartoon style, blue and orange colors

Claude generates the image via OpenRouter (google/gemini-3.1-flash-image), saves it to your account, and returns the CDN URL. Requires an OpenRouter key in MCP Settings.

Generate an image in the same style as https://www.publishmcp.net/images_published/1/my-image.png

Pass a reference_image_url and the model matches the visual style — ideal for keeping article images consistent across your site.

Upload this image and add it to my-article-slug

Attach an image in the Claude chat. Claude uploads it via upload_image and updates the article's image_url.

Generate a header image and update the article my-article-slug with it

Two-step in one prompt — Claude generates the image, gets the URL, then calls update_article to attach it.

Style consistency tip: Save the URL of your first article image. For every new image, say "generate in the same style as [URL]". The model uses it as a style reference so all your article images look related.

Research & Search Console

Connect your Google account in MCP Settings to let Claude check your Search Console data before writing — so articles target queries people are actually searching for.

List my Search Console sites

Shows all properties you have access to. Run this first to get the exact site_url format to use in other queries.

What search queries bring people to mysite.com?

Claude calls search_console_top_queries and returns queries ranked by impressions with clicks, CTR and position.

Find queries where I rank between position 5 and 20 — those are good article targets

Queries in positions 5–20 have proven search demand but aren't on page 1 yet. Writing targeted articles for these can move them up.

Check my top pages and write an article expanding on the most popular one

Claude calls search_console_pages to find your best performing content, then writes a follow-up article on the same topic.

Read-only access. PublishMCP only requests webmasters.readonly scope from Google — it can read Search Console data but cannot make any changes to your Google account.

Tips

Set tools to "Always approve" in Claude

In Claude's connector settings, set PublishMCP tools to "Always approve". Removes the popup on every tool call and makes the publishing flow much faster.

Use a Claude Project for your site

Create a Claude Project and add your style guide, tone instructions, and target domain to the project context. Every conversation in that project inherits it — no need to repeat instructions.

Research → write → publish in one conversation

Start with "check my Search Console queries", then "write an article targeting the top 3 gaps", then "publish them for mysite.com". Claude keeps full context throughout.

Export articles before migrating platforms

Use "Download articles as CSV" in MCP Settings. Attach the file to a Claude chat and say "import these to my Shopify/WordPress site". Your content is always yours.

ping publishmcp to test the connection

If something seems off, ask Claude to "ping publishmcp". Returns pong with your account ID — confirms the connector URL is working correctly.

Enable newsorwhat.com syndication for backlinks

In MCP Settings, enable syndication and add your articles base URL. Every article you publish will also be listed on newsorwhat.com with a do-follow link back to your site.

Quick Guide

Ready to publish?