What is the DOCX.now MCP server?
It lets an AI assistant use DOCX.now converters as structured tools. The client can discover supported routes, start a conversion, check its status, and return a secure download URL.
MCP endpoint
https://docx.now/mcp
The server uses stateless Streamable HTTP transport. Your client must support remote HTTP servers and custom authentication headers.
Connect DOCX.now to Codex
- 1Create an API key
Sign in and open Dashboard → API Access.
- 2Save the key
export DOCXNOW_API_KEY="docxnow_your_key_here" - 3Add the remote server
codex mcp add docx-now \ --url https://docx.now/mcp \ --bearer-token-env-var DOCXNOW_API_KEY - 4Check the connection
codex mcp get docx-now
Connect other MCP clients
Configuration names vary, but the URL and authentication header are the same:
{
"mcpServers": {
"docx-now": {
"url": "https://docx.now/mcp",
"headers": { "X-Api-Key": "docxnow_your_key_here" }
}
}
}
Authentication
Create or regenerate the key in the API dashboard. You may also send it as Authorization: Bearer …. It uses the same credits, limits, and ownership rules as the REST API and is never returned in tool output.
Verify the MCP connection
Ask your client: “List the available DOCX.now converters.” This calls list_converters without using credits. Then ask for API usage to confirm authentication.
401 means an invalid key; 402 means insufficient credits; 429 means the request limit was reached.DOCX.now MCP tools
| Tool | Purpose | Credits |
|---|---|---|
list_converters | Search valid conversion routes and formats. | No |
convert_image_url | Fetch a public URL and start the selected conversion. The legacy name is retained for API compatibility. | Yes |
get_conversion_status | Check a job and obtain its temporary download. | No |
get_api_usage | Read credits, recent usage, and limits. | No |
Example workflow
Ask your assistant:
Use the docx-to-pdf converter for the file at this public URL, wait for it to finish, and return the download link.
Security and limits
- Only public HTTP and HTTPS source URLs are accepted.
- Private, loopback, link-local, and reserved addresses are blocked.
- Every redirect is validated before it is followed.
- Source downloads are size-limited and use temporary storage.
- Files follow the normal DOCX.now retention policy.
Prefer direct HTTP integration? Read the DOCX.now REST API documentation.