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 Postman Desktop Agent to install the Transform MCP server by asking the Postman Desktop Agent the following:
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. From your terminal, authenticate with the Transform MCP server:
    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. Selecting the Unstructured Workspace
  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. Selecting the collection
  9. On the Unstructured Transform MCP Server tab, click Connect. If prompted, select All requests in this collection, and then click Grant access. Granting access to all requests in this collection
  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. Selecting the server request
  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. Checking whether tools are enabled
  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:
    Adding the path to the local folder for the server-filesystem package
  15. Click Add server. It will also show Tools enabled with a green circle icon. Enabling server-filesystem tools
  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.
  • 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:
    Note that in the preceding prompt, in this folder refers to </path/to/local/folder/> that you specified in the previous section.
The New user prompt area does not clear between messages. You can continue the conversation there throughout the session.
  1. 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 in the Postman documentation. Selecting the AI provider and model
  2. If your selected model requires you to provide an API key, click the Authorization tab and follow the on-screen directions. Providing an API key for the selected model
    This is the API key for your selected model’s provider. This is not your Unstructured API key.
  3. 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:
    Getting curl commands to upload source files

    Getting the set of curl commands to upload source files to Transform

    Running curl commands to upload source files

    Running the set of curl commands to upload source files to Transform

    Getting output files

    Getting the set of curl commands to download the output files from Transform

    Downloading output files

    Running the set of curl commands to download the output files from Transform

Next steps

Questions? Need help?