paper-format-agent — Claude Code MCP server for DOCX formatting
Format academic DOCX files against a guide without rewriting their text. A content check can stop the save if body or table text changes.
claude mcp add paper-format-agent -- uvx paper-format-agentWhat paper-format-agent does
The MCP server offers format_paper, extract_format_rules, and score_paper. It applies document rules for fonts, spacing, indents, headings, and captions from a formatting guide. Processing stays on your machine.
Before saving, it compares fingerprints for body paragraphs and tables. A mismatch aborts the write. Headers and footers are outside this check, while equations, footnotes, and complex layouts fare worse than regular paragraphs and tables. Keep a separate review in your submission workflow.
What it helps with
- format a DOCX to match a document guide
- extract layout rules from a sample file
- check body and table text after formatting
- score a paper's formatting before submission
Example prompts for the agent
- Format
paper.docxusingformat_guide.docxand save the result in./output. - Extract formatting rules from
format_guide.docx. - Score the formatting in
paper.docx.
How to install paper-format-agent
Platform CLI
claude mcp add paper-format-agent -- uvx paper-format-agentuvx runs the command named after the package; if the README names another one, use uvx --from paper-format-agent <command>
Platform CLI
codex mcp add paper-format-agent -- uvx paper-format-agentuvx runs the command named after the package; if the README names another one, use uvx --from paper-format-agent <command>
Config file
{
"mcpServers": {
"paper-format-agent": {
"command": "uvx",
"args": [
"paper-format-agent"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from paper-format-agent <command>
Config file
{
"servers": {
"paper-format-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"paper-format-agent"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from paper-format-agent <command>
Platform CLI
gemini mcp add paper-format-agent uvx paper-format-agentuvx runs the command named after the package; if the README names another one, use uvx --from paper-format-agent <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about paper-format-agent
How do I install paper-format-agent in Claude Code?
Run claude mcp add paper-format-agent -- uvx paper-format-agent to add the MCP server to Claude Code.
What does paper-format-agent do?
It formats a DOCX using a guide and checks whether body or table text changed during the run. If the check finds a change, it stops without saving the formatted file.
Which document content does the integrity check cover?
It checks body paragraphs and tables, but excludes headers and footers. Equations, footnotes, and complex layouts are less well handled than ordinary paragraphs and tables.
