Natural Voice MCP

A public, read-only MCP server for writing and rewriting in Soumik's natural voice. It runs on Cloudflare Workers over Streamable HTTP. This is an MCP service, not a hosted language model: the connected AI client drafts the text, and this server supplies the voice playbook and mechanical lint results.

Connect

After deployment, add this Streamable HTTP endpoint to an MCP-compatible client:

https://natural-voice-mcp.cold-mail-agent.workers.dev/mcp

For a client that accepts an MCP server URL:

{
  "mcpServers": {
    "natural-voice": {
      "url": "https://natural-voice-mcp.cold-mail-agent.workers.dev/mcp"
    }
  }
}

The endpoint is public and needs no authentication. Do not send confidential drafts to a public service unless your own privacy requirements allow it. The Worker processes tool input in memory, has no database or analytics binding, and does not call a model or store drafts. Cloudflare may still process normal service logs according to your account settings.

Related MCP server: Natural Voice MCP

Install the Codex plugin

This repository includes a Codex plugin manifest, a remote MCP connection, and a small skill that invokes the two tools. Add its marketplace and install the plugin:

codex plugin marketplace add emSoumik/natural-voice-mcp --ref main
codex plugin add natural-voice@natural-voice-repo

The existing local natural-voice skill is not deleted or changed. A fresh Codex task may be needed to load the newly installed plugin.

Tools

Registers: text, default, broadcast, pro, formal. The default is for most posts. Use pro for professional email, including cold outreach.

The complete source skill from the supplied ZIP is under skills/natural-voice/: SKILL.md, five references, agents/openai.yaml, the icon, and the original Python checker. The plugin uses a custom Natural Voice icon: a speech bubble with a compact n. mark. The editable SVG and a 512px PNG are in assets/ and the skill package. The server bundles this same skill and its references at build time, so it has no runtime GitHub dependency. It does not fabricate personal facts or send messages.

Develop

Node.js 22 or newer:

npm ci
npm run check
npm run dev

The local endpoint is http://localhost:8787/mcp unless Wrangler prints a different port. npm run check generates the content module, type-checks, runs tests, and performs a Worker dry run. npm run deploy repeats those checks and deploys to the account in wrangler.jsonc.

To change the public voice material, edit skills/natural-voice/ and rerun npm run build:content. Do not edit the generated src/playbook.ts. Review public examples before every push. Do not add private client drafts, credentials, or contact data.

Limits

The guidance tool gives a connected model instructions and examples; it does not produce a deterministic rewrite. The lint tool is a JavaScript port of the supplied Python checker and can have false positives. Preserve facts, names, links, and intended meaning during any model rewrite.

License

MIT. See LICENSE.