> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Unstructured Transform MCP server installation for Postman Desktop Agent

> Learn how to install the Unstructured Transform MCP server into the Postman Desktop Agent. You can then drag and drop files and have Unstructured start producing partitioned, enriched, chunked, and embedded data based on your files in minutes.

## Requirements

Before you begin, you must have the following:

* The Postman Desktop Agent installed on your local development machine.
  [Install the Postman Desktop Agent](https://www.postman.com/downloads/postman-agent/).
* A Postman account. To see if you have an account,
  [log in to Postman](https://identity.getpostman.com/login). If you do not have an account, [sign up for Postman](https://learning.postman.com/docs/getting-started/installation/account/sign-up-for-postman).
* 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](https://nodejs.org/en/download).

## Install the Transform MCP server

<Tip>
  You should be able to instruct the Postman Desktop Agent to install the Transform MCP server by asking the Postman Desktop Agent the following:

  ```text theme={null}
  Install the Unstructured Transform MCP server by using these instructions: 
  https://docs.unstructured.io/transform/install/postman.md
  ```

  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](#parse-your-source-files).
</Tip>

1. From your terminal, authenticate with the Transform MCP server:

   ```bash theme={null}
   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.

2. After you authenticate, back in your terminal, press `Ctrl + C` to exit and return to your terminal prompt.

3. Start the Postman Desktop Agent app.

4. If you are not already signed in to Postman, in the Desktop Agent's title bar, click **Sign in**, and follow the on-screen directions to finish signing in.

5. In Desktop Agent's title bar, in the **Search** box, enter `Unstructured`.

6. For filters, select **Visibility: Public** and **Type: Workspace**.

7. In the list of search results, select **Unstructured's Workspace**.

   <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/find-workspace.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=9c516002d4b49c6320855e3932cc8f33" alt="Selecting the Unstructured Workspace" width="268" height="91" data-path="img/transform/postman/find-workspace.png" />

8. On the sidebar, with the **Collections** panel expanded, and with the **Unstructured Transform MCP Server Collection** node expanded within this panel, click **Unstructured Transform MCP Server**.

   <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/transform-server-details.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=7cefea3d60eaa82a5fae977190efa47f" alt="Selecting the collection" width="351" height="132" data-path="img/transform/postman/transform-server-details.png" />

9. On the **Unstructured Transform MCP Server** tab, click **Connect**. If prompted, select **All requests in this collection**, and then click **Grant access**.

   <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/grant-server-access.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=84985095d479ffed75bdb71f78eda5df" alt="Granting access to all requests in this collection" width="812" height="396" data-path="img/transform/postman/grant-server-access.png" />

10. If a **Connection failed** or similar message appears, go back to your terminal and run the preceding `npx` command again, and then click **Connect** again.

11. After the Unstructured Transform MCP Server shows as **Connected** with a green circle icon, on the sidebar, click **Unstructured Transform MCP Server Request**.

    <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/transform-server-request-details.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=91f02d233905a3841a2fab026847304d" alt="Selecting the server request" width="352" height="130" data-path="img/transform/postman/transform-server-request-details.png" />

12. On the **Unstructured Transform MCP Server Request** tab, click **Tools**.

13. If **Disabled** appears, turn on the toggle to show **Tools enabled** with a green circle icon. If this does not work, go back to your terminal and run the preceding `npx` command again, and then turn on the toggle again.

    <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/tools-enabled.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=ed1a254985e30160b679f62429a9a4ec" alt="Checking whether tools are enabled" width="393" height="120" data-path="img/transform/postman/tools-enabled.png" />

14. In the **Add server** box, enter the following command, replacing `</path/to/local/folder>` with the path to the local folder where the files you want Transform to parse are stored:

    ```text theme={null}
    npx -y @modelcontextprotocol/server-filesystem </path/to/local/folder/>
    ```

    <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/local-folder-path.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=d949dc09293b0fd08b4efbfa5d57eb88" alt="Adding the path to the local folder for the server-filesystem package" width="855" height="250" data-path="img/transform/postman/local-folder-path.png" />

15. Click **Add server**. It will also show **Tools enabled** with a green circle icon.

    <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/filesystem-tools-enabled.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=39f2a12939dbfce3e11c09c44094c8e0" alt="Enabling server-filesystem tools" width="851" height="287" data-path="img/transform/postman/filesystem-tools-enabled.png" />

16. 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](/transform/supported-file-types).
* 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 Postman Desktop Agent about these limits. Because of this, the Postman Desktop Agent should notify you whenever it encounters a file that exceeds 50 MB in size. Also, the Postman Desktop Agent 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, make sure the **Unstructured Transform MCP Server Request** node is already expanded from the previous section.
2. On the **Prompt** tab, in the **New user prompt** area, enter the following prompt:

   ```text theme={null}
   Use the MCP Transform Unstructured server to parse the files in this folder.

   Provide the results as downloadable JSON files, one JSON file per source file.
   ```

   Note that in the preceding prompt, `in this folder` refers to `</path/to/local/folder/>` that you specified in the previous section.

<Tip>
  The **New user prompt** area does not clear between messages. You can continue the conversation there throughout the session.
</Tip>

3. In **Select a provider or enter URL**, select an AI provider and model that you want to use for this AI session. To learn more about this setting, see [Create a new AI request](https://learning.postman.com/docs/use/send-requests/protocols/ai-requests/create#create-a-new-ai-request) in the Postman documentation.

   <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/ai-chat-prompt.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=5ad5dbdadc1b33d04568da795701c26c" alt="Selecting the AI provider and model" width="731" height="203" data-path="img/transform/postman/ai-chat-prompt.png" />

4. If your selected model requires you to provide an API key, click the **Authorization** tab and follow the on-screen directions.

   <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/ai-api-key.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=613ce0d24f0f36abbbaba249f4e28ebd" alt="Providing an API key for the selected model" width="885" height="221" data-path="img/transform/postman/ai-api-key.png" />

   <Note>
     This is the API key for your selected model's provider. This is not your Unstructured API key.
   </Note>

5. Click **Send**, and follow the agent's on-screen directions. This will involve the agent asking you to run one or more `curl` commands yourself to upload your source files to Transform, as well as clicking one or more download links to download Transform's output JSON files based on your original source files.

   To respond to the agent or ask follow-up questions at any point, continue typing in the **New user prompt** area mentioned in step 2.

   For example:

   <Frame caption="Getting the set of curl commands to upload source files to Transform">
     <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/get-curl-commands.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=5f637a4638e82b0e5f586b166f2b9b3f" alt="Getting curl commands to upload source files" width="894" height="353" data-path="img/transform/postman/get-curl-commands.png" />
   </Frame>

   <Frame caption="Running the set of curl commands to upload source files to Transform">
     <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/run-curl-commands.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=13eeb1469405a86e1cc1bb0459ee9276" alt="Running curl commands to upload source files" width="2106" height="660" data-path="img/transform/postman/run-curl-commands.png" />
   </Frame>

   <Frame caption="Getting the set of curl commands to download the output files from Transform">
     <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/get-output-files.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=6ffa41cc30054e6d9ae6659b6b84b714" alt="Getting output files" width="1169" height="358" data-path="img/transform/postman/get-output-files.png" />
   </Frame>

   <Frame caption="Running the set of curl commands to download the output files from Transform">
     <img src="https://mintcdn.com/unstructured-53/NwNHJM7pKkV3jGYq/img/transform/postman/download-output-files.png?fit=max&auto=format&n=NwNHJM7pKkV3jGYq&q=85&s=d52141afd15451b2f934ba8f9f7839f0" alt="Downloading output files" width="1330" height="650" data-path="img/transform/postman/download-output-files.png" />
   </Frame>

## Next steps

* [Control Transform file parsing output](/transform/output): Control how the Unstructured Transform MCP server instructs Transform to partition, enrich, chunk, and embed the data based on your files.
* [Control Transform structured data extraction](/transform/sde): Control how the Unstructured Transform MCP server extracts and formats structured data from your files.
* [Control Transform generated sample code](/transform/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?

* For technical support, [request support](/support/request).