Skip to main content

​
Requirements

You will need:

​
Install the Transform MCP server

You should be able to instruct Grok Build to install the Transform MCP server by asking Grok Build the following:
During this process, Grok Build will open a browser window where you sign in to Transform to complete authentication. If you do not have a Transform account, click Register and then follow the on-screen directions to finish authenticating. Once authenticated, close the browser and return to Grok Build.If this does not work, to install the Transform MCP server manually, complete the following steps.
If you were able to install the Transform MCP server using the prompt above, skip ahead to parse your source files.
  1. From your terminal, register the Transform MCP server:
    Use the mcp-remote proxy instead.The following steps require Node.js installed on your local development machine. To see if it is, in your terminal, run node -v or node --version. Install Node.js.
    1. From your terminal, register the Transform MCP server using mcp-remote:
    2. From your terminal, run the following command to authenticate:
    3. Authenticate in your browser, and then press Ctrl + C to return to your terminal prompt. Skip the next step in the main procedure; you’ve already authenticated the Transform MCP server.
  2. Authenticate with the Transform MCP server:
    1. Arrow down to the listing for unstructured-transform [needs auth] and enter i.
    2. Follow the on-screen directions to finish authenticating in your browser.
  3. Verify you are connected to the Transform MCP server:
    Confirm that the server’s status is listed as handshake OK. 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 Grok Build about these limits. Because of this, Grok Build should notify you whenever it encounters a file that exceeds 50 MB in size. Also, Grok Build 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 start a Grok Build session, from your terminal, switch to the folder on your local machine that stores the files you want Transform to parse.
  2. Enter the following prompt:
    As needed, adapt the phrase in this project in the preceding prompt to indicate a more specific project folder. Also, as needed, guide Grok Build 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.

​
Extract structured data

If you want to pull specific fields from your files, instead of converting the files in full, ask for an extraction. To determine what structured data Transform can extract from your files, use a prompt similar to the following:
Your tool parses each file first, then extracts the field values from the parsed element JSON; this is because the Transform MCP extraction tools read a file’s parsed output, rather than the raw file itself. Transform returns results as JSON matching the schema, wrapped with the source filename so you can tell a batch apart. If you know the specific fields you want, include them in your prompt to guide Transform in extracting just the information that’s important to you. For more information, including prompting patterns and performance considerations, see Structured data extraction.

​
Next steps

​
Questions? Need help?