Unstructured Transform — Claude Code MCP server: setup guide
Converts files and raw documents into parsed, chunked, and embedded records for AI agents. It handles over 60 formats without manual pipeline setup.
claude mcp add --transport http transform https://mcp.transform.unstructured.ioWhat Unstructured Transform does
The MCP server connects directly to https://mcp.transform.unstructured.io over streamable-HTTP. It takes in spreadsheets, image scans, emails, and PDFs across 60+ formats. Output arrives as partitioned text chunks with metadata and embeddings ready for vector search or agent memory.
The server exposes several tools for the workflow. Files go through request_file_upload_url, while processing starts via start_transform_job or start_extraction_job. It can also recommend schema definitions with suggest_extraction_schema_for_file. Progress checks and final payloads rely on check_job_status and get_job_results.
Clients lacking native remote MCP capabilities must connect via npx mcp-remote.
What it helps with
- parse raw PDFs and scans into chunked text for RAG
- generate embeddings directly from document uploads
- draft extraction schemas for unstructured image or file data
- ingest spreadsheets and emails without external ETL pipelines
Example prompts for the agent
- Upload
contract.pdfand extract key clauses using a suggested schema - Process
quarterly_results.xlsxinto embedded chunks for vector storage - Check the status of transform job
job-9872and fetch results
How to install Unstructured Transform
Platform CLI: remote server
claude mcp add --transport http transform https://mcp.transform.unstructured.ioPlatform CLI: remote server
codex mcp add unstructured-transform --url https://mcp.transform.unstructured.ioConfig file
{
"mcpServers": {
"unstructured-transform": {
"url": "https://mcp.transform.unstructured.io"
}
}
}Config file
{
"servers": {
"unstructured-transform": {
"type": "http",
"url": "https://mcp.transform.unstructured.io"
}
}
}Platform CLI: remote server
gemini mcp add -t http unstructured-transform https://mcp.transform.unstructured.ioStep 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 Unstructured Transform
How to install Unstructured Transform in Claude Code?
Run claude mcp add --transport http transform https://mcp.transform.unstructured.io in your terminal.
What does Unstructured Transform do?
It converts files across 60+ formats into structured chunks and embeddings ready for AI agents or vector retrieval.
How do you connect clients that lack native remote MCP support?
You bridge the HTTP connection using npx mcp-remote pointing to the remote server URL.
