Skip to main content

​
Requirements

Before you begin, you must have the following:

​
Install the Transform MCP server

You should be able to instruct the Cursor IDE to install the Transform MCP server by asking the Cursor IDE the following:
Install the Unstructured Transform MCP server by using these instructions: 
https://docs.unstructured.io/transform/install/cursor-ide.mdx
If this does not work, to install the Transform MCP server manually, complete the following steps.If you are able to successfully connect, skip ahead to parse your source files.
  1. Start the Cursor IDE.
  2. On the menu bar, click Cursor > Preferences > Cursor Settings.
  3. On the Cursor Settings sidebar, click Tools & MCPs.
  4. In the Installed MCP Servers tile, click Add Custom MCP or New MCP Server. The Cursor IDE opens its mcp.json settings file in a new editor tab. This file is typically located at:
    • For macOS and Linux: ~/.cursor/mcp.json
    • For Windows: %APPDATA%\Cursor\mcp.json
  5. Add the following entry to the mcpServers object: 
    {
  "mcpServers": {
    "transform": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.transform.unstructured.io"]
    }
  }
}
  6. Save and close the mcp.json file.
  7. Quit the Cursor IDE.
  8. From your terminal, authenticate with the Transform MCP server: 
    npx -y mcp-remote https://mcp.transform.unstructured.io
    A web browser tab will appear, prompting you to authenticate with Transform. Follow the on-screen directions to finish authenticating.
  9. After you authenticate, back in your terminal, press Ctrl + C to exit and return to your terminal prompt.
  10. Restart the Cursor IDE.
  11. The Transform MCP server is ready for you to start using.

​
Parse your source files

Parsing requests have the following limits:
  • Each file must be of a supported file type.
  • Each file must be 50 MB or less in size.
  • Each request must have 10 files or fewer.
  • Only 5 requests can be running at a time.
The Transform MCP server is designed to notify the Cursor IDE about these limits. Because of this, the Cursor IDE should notify you whenever it encounters a file that exceeds 50 MB in size. Also, the Cursor IDE should formulate strategies to send requests that are 10 files or fewer and not cause more than 5 requests to be running at a time.
  1. After you install the Transform MCP server and restart the Cursor IDE, open the folder that stores the files you want Transform to parse (from the main menu, click File > Open Folder).
  2. In the Command Palette (from the main menu, click View > Command Palette), start typing >Open New, and then click Open New Agent Chat.
  3. In the New Agent tab, enter the following prompt:
Use the Unstructured Transform MCP server to parse the files in this project.

Provide the results as JSON files, one JSON file per source file.
As needed, adapt the phrase in this project in the preceding prompt to indicate a more specific project folder. Also, as needed, guide the Cursor IDE as to where to write Transform’s output into the project. Transform parses your input files and delivers its results to you as a set of output files, one output file per input file.

​
Next steps

  • Control Transform file parsing output: Control how the Unstructured Transform MCP server instructs Transform to partition, enrich, chunk, and embed the data based on your files.
  • Control Transform generated sample code: Control how the Unstructured Transform MCP server generates sample curl or Python code that demonstrates how to use Transform to partition, enrich, chunk, and embed the data based on your files.

​
Questions? Need help?