# PublishReady

Turn rough AI drafts into clear, credible, publish-ready writing without losing facts, voice, or domain nuance.  PublishReay provides deterministic editorial QA for AI-assisted writing including read…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add veldica/publishready

# Browse available tools
npx -y @smithery/cli@latest tool list veldica/publishready

# Get full schema for a tool
npx -y @smithery/cli@latest tool get veldica/publishready analyze_text

# Call a tool
npx -y @smithery/cli@latest tool call veldica/publishready analyze_text '{}'
```

## Tools (16)

- `analyze_text` — Return a deterministic writing analysis. MUST be used as the first step in most revision workflows to establish a basel…
- `analyze_against_targets` — Check text against an explicit target profile. Use this before rewriting. After producing a revision, call compare_text…
- `audit_ai_sounding_prose` — Run the Veldica AI marker inventory directly. Returns marker density, weighted score, style band, categories, exact mat…
- `suggest_revision_levers` — Rank deterministic revision levers. Use this before rewriting to identify high-impact changes. After revision, MUST cal…
- `analyze_against_template` — Check text against a built-in template. Use this before revising. After revision, call compare_text_versions with the s…
- `list_templates` — Return a list of available writing templates with their metadata.
- `get_template` — Return the full details of a specific template including its numeric targets.
- `interpret_targets` — Explain the human implications, likely audience, and tradeoffs of a set of numeric targets.
- `summarize_writing_profile` — Generate a fingerprint profile from a text sample.
- `build_reference_profile` — Generate a Fingerprint Profile from one or more high-quality reference texts.
- `compare_to_reference` — Compare current text against a specific Fingerprint Profile.
- `compare_profiles` — Compare two writing profiles, explicit target profiles, or templates.
- `find_reference_drift` — Detect if current writing samples are drifting away from a reference profile.
- `compare_text_versions` — Compare original and revised drafts. MUST be called after any revision to verify mechanical improvement and factual int…
- `find_hotspots` — Locate specific sentences or paragraphs for surgical revision. Each hotspot includes a 'hotspot_id' and 'revision_instr…
- `plan_revision_workflow` — Generate a step-by-step tool-call sequence for a specific revision task (e.g., fact-preserving revision, template align…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get veldica/publishready <tool-name>
```

## Resources

- `metrics://definitions` — Glossary of structural, lexical, and readability metrics exposed by the writing metrics server.
- `formulas://catalog` — Catalog of implemented readability formulas, assumptions, and interpretation notes.
- `schemas://targets` — JSON Schema reference for supported target constraints.
- `templates://catalog` — List of all built-in writing templates (nonfiction and fiction).
- `signals://metric_interpretations` — Guidance on how to interpret high/low values for key writing metrics.
- `profiles://reference_schema` — Schema definition for writing profiles and fingerprints.
- `targets://meaning_reference` — Human-readable reference for what specific numeric targets imply.
- `usage://tool_decision_tree` — Guidance on which tools to use for specific user goals.
- `usage://quality_gates` — Recommended quality thresholds for accepting a revised draft.
- `usage://revision_workflows` — Step-by-step recipes for common writing revision tasks.

## Prompts (12)

- `revise_prose` (text, goals) — Plan and verify a revision using deterministic writing metrics and explicit revision levers.
- `check_compliance` (text, targets_json) — Measure text against specific numeric targets and identify the most critical deterministic revision levers.
- `revise_without_losing_facts` (text, goals) — Improve style while ensuring factual anchors and core meaning are preserved.
- `match_reference_style` (draft, reference) — Analyze a reference text and revise a draft to match its stylistic fingerprint.
- `revise_to_template` (text, template_id) — Revise a draft to comply with a specific built-in writing template.
- `find_and_fix_hotspots` (text) — Locate specific readability drags and apply surgical fixes.
- `compare_revision_quality` (original, revised) — Exhaustively compare two versions of text to verify improvement and integrity.
- `build_style_profile` (texts) — Create a reusable stylistic fingerprint from one or more reference samples.
- `audit_ai_sounding_prose` (text) — Detect patterns common in AI-generated text and suggest humanizing revisions.
- `fiction_pacing_review` (text) — Analyze narrative metrics (dialogue, scene density) to optimize fiction pacing.
- `landing_page_copy_review` (text) — Audit scannability and impact for marketing or landing page copy.
- `technical_docs_review` (text) — Verify technical documentation against accessibility and clarity standards.

---

License: MIT