What it does
Convert document content between formats. Supported conversions: md→html, md→txt, html→md, html→txt, json→csv, csv→json. Returns the converted content and size in bytes. Use this as a preprocessing step when your pipeline receives content in one format but needs it in another before the next tool call.
When to use it
- Convert HTML scraped from a page to markdown before LLM processing
- Convert JSON API response to CSV for a spreadsheet export
- Normalise mixed-format inputs in a document processing pipeline
Request schema
{
"from": "html",
"to": "md",
"content": "<h1>Hello</h1><p>World</p>"
} Response schema
{
"from": "html",
"to": "md",
"content": "# Hello\n\nWorld",
"size_bytes": 14
} Code example — TypeScript via MCP
Install the MCP server once; all 16 services become tool calls.
// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:
const result = await mcpClient.callTool("docconvert_text", {
"from": "html",
"to": "md",
"content": "<h1>Hello</h1><p>World</p>"
});
console.log(result);
// ["from","to","content","size_bytes"]... → MCP setup guide Code example — Python via direct HTTP
import requests
# x402 payment header must be set by your wallet client
# See x402.org for client libraries
headers = {
"Content-Type": "application/json",
"x-payment": "<signed-x402-payment-header>",
}
resp = requests.post(
"https://docconvert-text.melis.ai/convert",
json={
"from": "html",
"to": "md",
"content": "<h1>Hello</h1><p>World</p>"
},
headers=headers,
)
print(resp.json()) Code example — curl with internal key bypass
For testing with an issued internal key (skips x402 payment flow):
curl -X POST https://docconvert-text.melis.ai/convert \
-H "Content-Type: application/json" \
-H "x-internal-key: YOUR_KEY" \
-d '{"from":"html","to":"md","content":"<h1>Hello</h1><p>World</p>"}' FAQ
Does it work without an account?
Yes. x402 is account-less. Your agent's wallet signs the payment and retries automatically. No registration, no API key, no subscription.
What happens on failure?
Returns HTTP 422 for unsupported format pairs.
What is the rate limit?
None published.
Is this open-source?
The service code is closed-source for security reasons. The MCP wrapper that calls it is open-source and MIT-licensed: github.com/mizukaizen/x402-tools-mcp .
Who built this?
Part of the melis.ai agent infrastructure stack. Running on a dedicated Helsinki VPS since early 2026. Contact sean@melis.ai.