Vespper MCP

The docx MCP for agents

Give your AI agents two tools to read Word documents as HTML and apply edits as Word tracked changes — never silent overwrites. Connect once via MCP; your agent handles .docx from there.

Setup

Cursor speaks Streamable HTTP natively. Add the server to .cursor/mcp.json, drop in your sk_live_ key, and restart your client.

.cursor/mcp.json
{
  "mcpServers": {
    "vespper-docx-mcp": {
      "url": "https://mcp.vespper.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}

Endpoint: https://mcp.vespper.com/mcp · Transport: Streamable HTTP · Claude Desktop speaks stdio, so bridge it with mcp-remote.

Tools

Two tools, no server-side session. Typical flow: read_documentedit_document → continue with the returned base64 or save the file locally.

read_document
Argumentsbase64_data (hosted HTTP) or path (local stdio)
Returnshtml, approx_tokens, bytes
edit_document
Argumentsbase64_data, edits: [{ old, new }], author
Returnsok, count, bytes, base64, message

What you can do

Read as HTMLLoad a .docx and get back an HTML projection your agent can reason over — plus approximate token count and byte size.
Edit with tracked changesApply { old, new } HTML edits. Each change lands as a Word suggestion a human can accept or reject — never a silent overwrite.
Curated tool instructionsThe tools ship the editing rules agents need — block anchoring, lazy classes, batching, tracked-change semantics — so you don't replicate them in a prompt.
Works everywhereStreamable HTTP. Connect from Cursor, Codex, Gemini CLI, Copilot CLI, Claude Desktop, or SDKs like OpenAI Agents, Mastra, and Vercel AI.
Bearer authAuthenticate with an sk_live_ key passed in the Authorization header — no OAuth dance for local agent setups.
Stateless by designNo server-side session — your client owns the bytes. Pass the current document on each call and continue with the returned base64.

Common use cases

Redline an incoming contract .docx and leave clauses as Word suggestions
Read a Word document as HTML and extract sections for review
Apply reviewer edits as tracked changes before human sign-off
Batch independent edits across a document in a single call
Pipe agent revisions into your team's existing Word review workflow
Ready to connect?Sign up, grab a key, and add Vespper to your MCP config.
Get started free
Vespper Logo
Coming Soon