# Publishready Mcp

> PublishReady: Turn AI drafts into publish-ready writing.

- **Type:** MCP server
- **Install:** `agentstack add mcp-veldica-publishready-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [veldica](https://agentstack.voostack.com/s/veldica)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [veldica](https://github.com/veldica)
- **Source:** https://github.com/veldica/publishready-mcp

## Install

```sh
agentstack add mcp-veldica-publishready-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PublishReady: Professional Writing Control

[](https://github.com/veldica/publishready-mcp/actions/workflows/ci.yml)
[](https://opensource.org/licenses/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](packages/mcp)**: The Model Context Protocol (MCP) server implementation (`publishready-mcp`).
- **[@veldica/publishready-cli](packages/cli)**: The command-line tool for local analysis (`publishready`).
- **[@veldica/publishready-core](packages/core)**: The central orchestration engine.
- **[@veldica/publishready-schemas](packages/schemas)**: Unified Zod schemas and explicit interfaces.

### Underlying Libraries
- **[@veldica/prose-analyzer](https://www.npmjs.com/package/@veldica/prose-analyzer)**: Deterministic style signals (variety, density, repetition, narrative texture).
- **[@veldica/readability](https://www.npmjs.com/package/@veldica/readability)**: Consolidated library of all major readability formulas.
- **[@veldica/prose-tokenizer](https://www.npmjs.com/package/@veldica/prose-tokenizer)**: Standalone markdown-aware prose tokenization.
- **[@veldica/prose-linter](https://www.npmjs.com/package/@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"]
    }
  }
}
```

### Command Line
```bash
npx @veldica/publishready-cli analyze sample.txt
```

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

```bash
npx @veldica/publishready-mcp --transport=http --port=3000
```

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](packages/mcp/README.md).

## Deterministic Philosophy

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

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

## Development

```bash
npm install
npm run build
npm run lint
npm run typecheck
npm test
```

## 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

[](https://smithery.ai/servers/veldica/publishready)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [veldica](https://github.com/veldica)
- **Source:** [veldica/publishready-mcp](https://github.com/veldica/publishready-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-veldica-publishready-mcp
- Seller: https://agentstack.voostack.com/s/veldica
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.