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

# Cursor

> Configure Cursor MCP with Alchemyst AI

### Prerequisites

Before starting, make sure you have:

* **Visual Studio Code v1.101+** installed.
* A valid **Alchemyst Platform API key**.
* MCP must be enabled in Cursor.

Now, to configure **Alchemyst AI** with **Cursor** via **MCP**, follow the below commands:

### Configuring via mcp.json

1. Launch **Cursor** application on your (Mac/Windows).
2. Invoke the **Command Palette** with `⌘K` (Mac) or `Ctrl+Shift+P` (Windows).
3. Search for and select:
   **Settings → Cursor Settings.**
4. In the **Settings** sidebar, search and navigate to:
   **`Tools & MCP`**
5. On the **Tools & MCP** page, you will be able to see a button named:
   **`New MCP server`**
   Click on it.
6. When you click on the **New MCP Server** button, the `mcp.json` file will be opened automatically.
7. Now, in the `mcp.json` file, you will see the **"mcpServers"** object. Add the following section inside the **"mcpServers"** object:

```json theme={null}
"your_mcp_server_name": {
      "url": "https://mcp.getalchemystai.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_ALCHEMYST_PLATFORM_API_KEY"
      }
    }
```

8. Change `your_mcp_server_name` to the name you want to give your MCP server. e.g., `Alchemyst`.
9. Change `YOUR_ALCHEMYST_PLATFORM_API_KEY` to your own key, which you will get after logging into the **[Alchemyst Platform](https://platform.getalchemystai.com)**.
10. Now, save the file and navigate back to the **`Tools & MCP`** page inside the **Cursor settings**.
11. Here, you will be able to see your added MCP Server.
12. Make sure the toggle button in front of the MCP server is **ON (green)**, and there should be a green dot on the icon of your MCP server, indicating the server is running successfully.
13. If so, then congratulations to you. Your **Cursor** is now integrated with **Alchemyst AI**.

**Your Alchemyst MCP server is now live inside Cursor!**

## Troubleshooting

| Issue                    | Possible Cause                     | Fix                                                                                                                                                      |
| :----------------------- | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MCP toggle is missing    | Outdated Cursor version            | Update Cursor to the latest version                                                                                                                      |
| SSE connection fails     | Network restrictions or firewall   | Allow outbound access to `https://mcp.getalchemystai.com`                                                                                                |
| "Authorization failed"   | Incorrect or expired API key       | Regenerate your API key from [**Alchemyst Dashboard**](https://getalchemystai.com?utm_source=docs.getalchemystai.com\&utm_campaign=docs\&utm_medium=web) |
| MCP server not appearing | `mcp.json` not formatted correctly | Validate your JSON syntax                                                                                                                                |
| No context syncing       | MCP service not started            | Click **Start** beside the MCP server entry in Cursor                                                                                                    |