Publishready

io.github.veldicaPublished by GitHub account veldicav1.0.5Updated Oct 27, 2026

PublishReady: Deterministic writing control with local-first metrics and AI prose audits.

VerifiedSTDIODesktop onlyDeveloper Tools AI & ML

Server details

Identifier: io.github.veldica/publishready
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account veldica for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.veldica%2Fpublishready.svg)](https://sourceweft.com/mcp/io.github.veldica%2Fpublishready?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local-first MCP server that gives an assistant deterministic prose metrics, readability scores, target checks and revision levers for polishing drafts.

What you can do: Analyze prose with deterministic metrics: structural counts, sentence and paragraph distributions, lexical signals, scannability and readability formulas
Compare a draft against built-in templates, numeric targets, reference text or reusable reference profiles
Get ranked, evidence-based revision levers such as shortening long sentences or replacing difficult words
Audit AI-sounding prose with a deterministic marker inventory, exact matches and tracked phrase counts
Interpret targets and metrics with audience, use-case, style and tradeoff explanations, including fiction narrative metrics
When to use it: Useful as a final QA pass when an assistant has drafted or edited prose and you want reproducible, explainable feedback on clarity, structure and readability before publishing. Also fits fiction and non-fiction editing where narrative and pacing signals matter.
Requirements: Runs as a local stdio process, typically launched with npx from the npm package @veldica/publishready-mcp, so Node.js and network access for the package fetch are needed. No accounts, API keys, environment variables or headers are declared. An optional HTTP transport mode exists for hosted deployments.

Before you install

The README states it makes no external API calls and sends no text to remote services, but that claim is the vendor's own. If you run it in the optional HTTP transport mode on a server, the text you submit is exposed to that endpoint, so secure it yourself. Analysis is read-only; revision suggestions are applied by the assistant, so review edits before publishing.

Installation

In SourceWeft

Open Publishready in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

PublishReady: Professional Writing Control

[CI] [License: MIT]

PublishReady is a deterministic writing analysis system designed to turn AI drafts into publish-ready writing. It serves as the final QA pass for AI-generated prose, providing local-first metrics, target compliance, and specific revision levers without sending text to remote services.

The PublishReady Packages

This project is structured as a professional, layered monorepo containing specialized packages:

Core Packages

@veldica/publishready-mcp: The Model Context Protocol (MCP) server implementation (publishready-mcp).
@veldica/publishready-cli: The command-line tool for local analysis (publishready).
@veldica/publishready-core: The central orchestration engine.
@veldica/publishready-schemas: Unified Zod schemas and explicit interfaces.

Underlying Libraries

@veldica/prose-analyzer: Deterministic style signals (variety, density, repetition, narrative texture).
@veldica/readability: Consolidated library of all major readability formulas.
@veldica/prose-tokenizer: Standalone markdown-aware prose tokenization.
@veldica/prose-linter: Target checks, revision levers, content integrity, and deterministic AI-sounding prose markers.

Installation

MCP Server (Recommended)

Add the server to your MCP client configuration:

json

{  "mcpServers": {    "publishready": {      "command": "npx",      "args": ["-y", "@veldica/publishready-mcp"]    }  }}

{  "mcpServers": {    "publishready": {      "command": "npx",      "args": ["-y", "@veldica/publishready-mcp"]    }  }}

Command Line

Hosted MCP

For Smithery, VPS, or gateway deployments, run the server with Streamable HTTP:

The MCP endpoint is /mcp; the health endpoint is /health.

Key Features

Template, Target, and Reference Modes: Compare writing against built-in templates, explicit numeric targets, reference text, or reusable reference profiles.
Deterministic Metrics: Structural counts, sentence and paragraph distributions, lexical signals, scannability, fiction proxies, and readability formulas.
Specific Revision Levers: Ranked, evidence-based suggestions such as shorten_long_sentences, replace_difficult_words, and reduce_abstract_wording.
AI-Sounding Prose Audit: Deterministic marker inventory for formulaic, generic, or over-polished prose, including exact matches and tracked phrase counts.
Fiction & Non-Fiction Support: Narrative metrics for dialogue, sensory density, abstract wording, and scene pacing.
Explainable Interpretation: Target and metric interpretation that explains audience, use cases, style implications, and tradeoffs.
Local-First & Private: Stdio-first, deterministic, no external API calls, and no LLM wrappers.

MCP Tool Surface

The MCP server exposes 16 specialized tools for analysis and control, including audit_ai_sounding_prose for deterministic AI-marker analysis. For a full list and documentation, see the MCP README.

Deterministic Philosophy

This package explicitly avoids perplexity and other model-dependent scores. We believe writing control should be:

Explainable: You should know exactly why a score changed.
Reproducible: The same text should always yield the same metrics.
Practical: A metric is only useful if it tells you what to change.

Development

Publishing Metadata

npm package: @veldica/publishready-mcp
MCP Registry name: io.github.veldica/publishready
Product homepage: https://veldica.com/publish-ready
Source repository: https://github.com/veldica/publishready-mcp

Registry and Directory Metadata

PublishReady is prepared for MCP directory discovery through:

GitHub repository topics
npm package keywords
Glama metadata via glama.json
Official MCP Registry metadata via mcpName

This MCP is designed for AI-assisted writing workflows where the model should improve clarity, structure, readability, and publish-readiness while preserving facts, terminology, intent, and author voice.

License

MIT

[smithery badge]

Source: README.md at commit bca1cee

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts