Unstructured Foundation installation for the Cursor IDE

​

Requirements

Before you begin, you must have the following:

• Acceptance by Unstructured into its Early Access program for Foundation. Add your name to the Early Access interest list. Do not begin this installation until you have received your Early Access acceptance email from Unstructured.
• A Cursor plan. Sign up for Cursor.
• The Cursor IDE installed on your local development machine. Install the Cursor IDE.
• 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.

​

Set up Foundation

1. Open the Cursor IDE’s mcp.json settings file in a text editor. This file is typically located at:
   • For macOS and Linux: ~/.cursor/mcp.json
   • For Windows: %APPDATA%\Cursor\mcp.json
2. Add the following entry to the mcpServers object:
   {
     "mcpServers": {
       "foundation": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://mcp.foundation.unstructured.io/mcp"]
       }
     }
   }
   
3. Save and close the mcp.json file.
4. From your terminal, authenticate with the Foundation MCP server:
   npx -y mcp-remote https://mcp.foundation.unstructured.io/mcp
   
   A web browser tab will appear, prompting you to authenticate with Unstructured. Follow the on-screen directions to finish authenticating.
5. After you authenticate, back in your terminal, press Ctrl + C to exit and return to your terminal prompt.

​

Connect to and index your source

1. In the New Agent tab, enter the following prompt: Generate a link to connect Unstructured Foundation to a new source. To display the New Agent tab, do the following: a. On the main menu, click View > Command Palette.
   b. In the Command Palette, begin typing >Open New (don’t forget to start with >).
   c. In the list of matching commands, click Open New Agent Chat.
   
2. Click the link that appears in the response. If the link does not appear, go to the following link in your web browser instead: https://foundation.unstructured.io/connect
3. If prompted, sign in to Foundation.
4. The Connect sources to use Foundation page appears. If this page does not appear after you sign in to Foundation, click the New Source button to show a page with similar functionality.
5. Click one of the available sources, and then click Connect.
6. Follow the on-screen directions to finish connecting to your source.
7. View the source files’ ingestion and indexing job’s progress. To do this, on the sidebar, click Summary.
8. Wait until the source’s tile displays Fully indexed.
9. You can now start using the Cursor IDE to work with the generated index. For example, you can ask the Cursor IDE questions such as the following:
   What is a summary of the kinds of information that are available in the Unstructured Foundation index about my sources?
   
   What are some examples of the kinds of questions I can ask the Unstructured Foundation index about my sources?
   

​

Next steps

• To learn more about how to use Unstructured Foundation, enter the following prompt in the Cursor IDE: Teach me how to use Unstructured Foundation.
• Manage your Foundation sources: Add, change, and remove sources from Foundation.
• Foundation storage: Understand what artifacts that Foundation generates, indexes, and stores about your sources.
• Troubleshoot Foundation: Solutions for common issues.

​

Questions? Need help?

• For general questions about Unstructured products and pricing, email Unstructured Sales at sales@unstructured.io.
• For technical support, request support.