Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

NewsBlog Composer

by Mohammed-Jameal-Jversion 0.8.0i★ 1iRuns on your computerRepository ↗
Registry nameio.github.Mohammed-Jameal-J/newsblog-composer

How to install

What it does

Verifies news stories, mines SEO keywords, builds schema and reviews your draft. You write it.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Marketing & social media

Use together with

Skills that teach the AI this kind of work; they work alongside this one

scroll-world

A skill that turn any brand into a scrollable 3D world landing page

by oso95★ 11,0791 skills

Skill · How-to guide

social-auto-upload

自动化上传视频到社交媒体:抖音、小红书、视频号、tiktok、youtube、bilibili

by dreammis★ 16,718 (whole repo)4 skills

Skill · How-to guide

native-subtitle-quote-image

保留视频内嵌字幕,精确取帧并生成 3:4 社交长图的 Agent Skill

by chengyi-ai★ 2,8931 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score11/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install NewsBlog Composer. Follow https://mcp.popnx.com/i/mohammed-jameal-j-newsblog-composer.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server NewsBlog Composer for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "newsblog-composer": { "command": "uvx", "args": [ "newsblog-composer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NewsBlog Composer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "newsblog-composer": {
          "command": "uvx",
          "args": [
            "newsblog-composer-mcp"
          ]
        }
      }
    }
  4. Quit Claude and open it again

  5. Try it

    Use NewsBlog Composer and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using NewsBlog Composer or shows a NewsBlog Composer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • TAVILY_API_KEY Optional. Search provider; keyless GDELT is used when absent.
  • GPTZERO_API_KEY Optional. Real AI-detection reading; without it no detection score is reported.
  • CLOUDFLARE_ACCOUNT_ID Optional. Image generation via Workers AI.
  • CLOUDFLARE_API_TOKEN Optional. Image generation via Workers AI.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect NewsBlog Composer yet

NewsBlog Composer runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect NewsBlog Composer

  • Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)
  • Install Python (uv) on your computer first (one time)

B · Others in Marketing & social media that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server NewsBlog Composer for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user newsblog-composer -- uvx newsblog-composer-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NewsBlog Composer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user newsblog-composer -- uvx newsblog-composer-mcp
  4. Type /mcp in Claude Code

    You should see NewsBlog Composer listed as connected

  5. Try it

    Use NewsBlog Composer and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using NewsBlog Composer or shows a NewsBlog Composer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • TAVILY_API_KEY Optional. Search provider; keyless GDELT is used when absent.
  • GPTZERO_API_KEY Optional. Real AI-detection reading; without it no detection score is reported.
  • CLOUDFLARE_ACCOUNT_ID Optional. Image generation via Workers AI.
  • CLOUDFLARE_API_TOKEN Optional. Image generation via Workers AI.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server NewsBlog Composer for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "newsblog-composer": { "command": "uvx", "args": [ "newsblog-composer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NewsBlog Composer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Open the AI chat in Cursor in Agent mode

  4. Try it

    Use NewsBlog Composer and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using NewsBlog Composer or shows a NewsBlog Composer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • TAVILY_API_KEY Optional. Search provider; keyless GDELT is used when absent.
  • GPTZERO_API_KEY Optional. Real AI-detection reading; without it no detection score is reported.
  • CLOUDFLARE_ACCOUNT_ID Optional. Image generation via Workers AI.
  • CLOUDFLARE_API_TOKEN Optional. Image generation via Workers AI.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server NewsBlog Composer for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "newsblog-composer": { "type": "stdio", "command": "uvx", "args": [ "newsblog-composer-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the NewsBlog Composer tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install uv (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    uv --version
    • A version number such as uv … = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required

    Open the uv download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version

    Install once; it works for everything that needs uv

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Open the AI chat in VS Code in Agent mode

  4. Try it

    Use NewsBlog Composer and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using NewsBlog Composer or shows a NewsBlog Composer tool in the answer, you are connected

4 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • TAVILY_API_KEY Optional. Search provider; keyless GDELT is used when absent.
  • GPTZERO_API_KEY Optional. Real AI-detection reading; without it no detection score is reported.
  • CLOUDFLARE_ACCOUNT_ID Optional. Image generation via Workers AI.
  • CLOUDFLARE_API_TOKEN Optional. Image generation via Workers AI.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use NewsBlog Composer💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user newsblog-composer -- uvx newsblog-composer-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "newsblog-composer": {
      "command": "uvx",
      "args": [
        "newsblog-composer-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "newsblog-composer": {
      "command": "uvx",
      "args": [
        "newsblog-composer-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "newsblog-composer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "newsblog-composer-mcp"
      ]
    }
  }
}

Values you fill in

  • TAVILY_API_KEY secret env
    Optional. Search provider; keyless GDELT is used when absent.
  • GPTZERO_API_KEY secret env
    Optional. Real AI-detection reading; without it no detection score is reported.
  • CLOUDFLARE_ACCOUNT_ID env
    Optional. Image generation via Workers AI.
  • CLOUDFLARE_API_TOKEN secret env
    Optional. Image generation via Workers AI.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
58/wk
Connection
Runs on your computer
Latest versioni
0.8.0
Published to registryi
Oct 11, 2026
Code last changedi
Oct 10, 2026
Maker
Mohammed-Jameal-J
Packages
pypi: newsblog-composer-mcp
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Mohammed-Jameal-J, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 41 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for newsblog-composer-mcp@0.8.0

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mohammed-jameal-j-newsblog-composer.svg)](https://mcp.popnx.com/en/servers/mohammed-jameal-j-newsblog-composer)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Marketing & social mediai

  • More stars than 86% of the other 4243 servers in this category
  • Published to the registry more recently than 40% of the other 4243 servers in this category
  • Basic checks equal to or better than 99% of the other 4243 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is NewsBlog Composer safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 41 days ago, and the latest version (0.8.0) reached the registry 40 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

ChatbotX

Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.

by ChatbotXIOGrowing★ 1.1K Stars for the whole repoUpdated 14 days ago

Runs in the cloud✓ service owner · chatbotx.io

Betterlytics

Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.

by betterlyticsGrowing★ 196Updated 4 months ago

Runs in the cloud✓ service owner · betterlytics.io
Compared with similar ones
This one
NewsBlog Composer
RelaticleChatbotXX (Twitter) MCP Server by XquikBetterlyticsBibiGPT YouTube Video Summarizer
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/44/44/4
LicenseMITAGPL-3.0NOASSERTIONMITAGPL-3.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

NewsBlog Composer MCP

Headline in, publishable post out.

Give it a news headline or a topic and it verifies the story is real, downloads the sources, extracts the facts with attribution, mines the keywords, writes the article, and builds the SEO, schema, banner prompt and publishing pack around it.

"Write me a blog post about <a headline from today>"

verify_news 8 independent publishers, corroborated fetch_article_facts facts, quotes and figures, each with its source URL seo_keywords mined from the fetched text, not invented draft_brief structure + facts -> the article gets written find_ai_words stock phrasing flagged with the sentence it sits in build_publishing_pack asks YOU which of 8 banner styles you want build_schema NewsArticle + FAQPage JSON-LD, validated seo_audit 93/100, nothing must-fix save_and_present the post, the checks, the image prompt, the files

No Claude subscription? Use it from the command line

Extensions, connectors and skills are all gated behind a paid Claude plan, so none of them reach a free account. This does.

Look at what the pipeline actually does: verification, the two-publisher rule, wire and reshare detection, fact extraction, keyword mining, the SEO score, the AEO score, the JSON-LD and the publishing pack are ordinary Python. Exactly one step needs a language model - writing the draft - and you already have one of those for free, whichever chatbot you use.

So the model is yours to supply, by pasting:

pip install newsblog-composer-mcp

newsblog setup # byline, voice, blog URL. Once. newsblog find "ransomware attack" # what is worth writing about today newsblog brief " " # verifies, fetches, writes brief.md

Paste brief.md into any chatbot. Save what it gives you as draft.md. Then:

newsblog pack draft.md --banner hardware_macro

That audits the draft, scores it for SEO and AEO, builds both JSON-LD blocks and writes the whole package, including the file you paste into Blogger.

No API key is needed for technology, AI or security stories: the bundled publisher feeds are keyless. newsblog doctor --probe --feeds reports what is configured and what is actually reachable.

The one thing it will not do is write from a story it could not verify. That refusal is the product, not a limitation of this entry point.

What it actually guarantees

Two independent publishers, or it will not draft. Wire reprints are detected, so six outlets running one Reuters story are not mistaken for six sources, and a wide date spread downgrades confidence rather than passing silently.

Every fact traces to a source it fetched, not to a model's memory. Facts, quotes and figures carry their source_url, and build_schema rejects reference links that are aggregator redirects rather than real publisher URLs.

You choose the banner. With no style picked there is no image prompt in the result at all, and save_and_present refuses the package. The tool asks; it does not decide for you.

It will not hand you a post without the numbers. save_and_present refuses unless the SEO audit and the AI-word check have both run, so the finished post always arrives with its scores attached.

Two scores, not one: SEO and AEO. seo_audit returns both. SEO is the on-page pass. AEO — Answer Engine Optimisation — is whether an assistant can lift a correct, self-contained answer off the page and cite it: a 40-60 word opening answer, question-shaped headings, short paragraphs, a figure with a source, a visible FAQ. It is structure, not keywords, and a page can score well on one and badly on the other. Both appear on the Checks table.

It links to your own earlier posts, and only where that is justified. Every post is recorded in an index beside your profile, and suggest_internal_links matches a new draft against it on shared entities and keyword overlap. Below the relevance floor it returns nothing, because an irrelevant internal link is worse than no link. These are internal links, not backlinks: a backlink lives on somebody else's site, and no tool can create one.

The prose is machine-written and the tool says so. Without a detector API key score_ai_text reports Not measured rather than inventing a reassuring number — a local style score measures cliche density and sentence rhythm, which is not a prediction of what a detector will say. If the byline is going to claim a person wrote it, that is your call to make with your eyes open; review_draft exists so the draft gets edited rather than published raw.

It runs with zero API keys. Every credential is an upgrade, not a requirement. See No keys? Start here.


Install

Claude Desktop — one click, no Python
  1. Download newsblog-composer- .mcpb from Releases.
  2. Claude Desktop → Settings → Extensions → Advanced settings → Install Extension.
  3. Toggle the extension off and on. On Windows the X button only minimises to the tray, so without this the old server keeps running.
  4. Add this line to a Claude project's instructions, or to Customize so it applies to every chat:

When I ask for a blog post, an article, or a news write-up, always use the

NewsBlog Composer tools. Start with write_blog_post. Never search the web

and draft the article yourself.

  1. Ask for a post. It asks for your byline, company and blog domain once.

Step 4 is not optional. A host's system prompt reads "write me a blog post" as "search the web and make an artifact", and an MCP server's instructions field cannot outrank that — there is no API for a server to claim priority. Without the line the client answers from web search and never mentions the extension. Naming the server in the request works for one-offs.

Extensions are desktop only. On mobile or the web app there is nothing to call, and the client answers from web search without saying so.

From PyPI
pip install newsblog-composer-mcp

That gives you the newsblog-mcp command, which speaks MCP over stdio.

From source
git clone https://github.com/Mohammed-Jameal-J/newsblog-composer-mcp.git

cd newsblog-composer-mcp python3 -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -e . cp .env.example .env # optional: every value in it is optional too

Check it reaches the network before wiring it into a client — if search is blocked by a proxy or VPN, this is where you find out:

python -m newsblog_mcp.diagnose "a headline you saw in the news today"

Connect it

VS Code

Create .vscode/mcp.json in your workspace:

{

"servers": { "newsblog": { "type": "stdio", "command": "newsblog-mcp" } } }

Reload the window, then open Chat in Agent mode — the tools appear under the tools picker. Use the full path to newsblog-mcp (or to the venv's Python with "args": ["-m", "newsblog_mcp.server"]) if the command is not on your PATH.

Claude Code

.mcp.json in your project:

{

"mcpServers": { "newsblog": { "command": "newsblog-mcp" } } }

Claude Desktop, configured by hand

%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS:

{

"mcpServers": { "newsblog": { "command": "newsblog-mcp" } } }

The .mcpb above does this for you and is the easier route.

Anything else

Launch newsblog-mcp (or python -m newsblog_mcp.server) and speak MCP over stdio. For a remote client, newsblog-mcp --http serves a streamable HTTP endpoint — see Publishing and connecting.

Where it keeps your files

Installed any way other than a source checkout - from PyPI, or as a one-click Claude Desktop extension - the server writes to your user data directory, so nothing is lost when you upgrade:

Windows%LOCALAPPDATA%\newsblog-composer-mcp
macOS~/Library/Application Support/newsblog-composer-mcp
Linux~/.local/share/newsblog-composer-mcp

That folder holds profile.json (the identity you set at first run), output/ (every generated post) and an optional .env. Set NEWSBLOG_DATA_DIR to put them somewhere else. Run from a cloned checkout instead and everything stays in the project folder, beside the code.

This matters for the extension install in particular. Claude Desktop replaces an extension's folder wholesale on every upgrade, so anything written beside the code is destroyed the first time you update. Before 0.5.2 that is exactly what happened, because a packed extension contains pyproject.toml and src/ and looked like a developer checkout. It now writes to the data directory above.

python -m newsblog_mcp.diagnose prints the exact paths for your install.


Publishing and connecting

Claude Desktop / Claude Code run it over stdio, which is what the install section above sets up.

ChatGPT cannot spawn a local process, so stdio will never reach it. Run the same server over HTTP and deploy it behind HTTPS:

newsblog-composer-mcp --http --host 0.0.0.0 --port 8000

Then in ChatGPT: Settings → Connectors → Advanced → Developer mode, then Add custom connector pointing at https://your-host/mcp. Custom connectors need a Pro, Team, Enterprise or Edu plan.

Publishing to the MCP Registry needs the package on PyPI first, then the mcp-publisher CLI with server.json in this repo. Four things must line up or the publish is rejected:

  • name must match the authenticated GitHub account: io.github. /newsblog-composer
  • description must be 100 characters or fewer
  • packages[].version must be a release that already exists on PyPI
  • the README must carry mcp-name: on its own line. The registry proves package ownership by reading the description PyPI serves for that exact version, so the marker has to be in the release you uploaded, not just in the repo. It is the HTML comment at the top of this file.

How to test it

Three levels, cheapest first.

1. Offline, no network — proves the logic.

python tests\smoke_test.py

272 checks covering schema parity, the SEO audit, AI-word detection, publisher identity behind aggregator links, clustering, the publishing pack, the derived image concept, the trademark filter and the install paths. All should pass in about two seconds.

2. Network — proves search reaches you.

python -m newsblog_mcp.diagnose "a headline you saw in the news today"

One line per provider with timings, then the verdict. What you want to see is independent_publishers naming several real outlets and reference_candidates holding real publisher URLs.

3. A whole post, end to end.

python examples\build_today_example.py

Builds a complete package from a real story using facts already in the file, and prints the keywords, schema validation, AI-word check, human score and SEO score before writing the output folder. U

Only the beginning is shown; read the rest in the repo