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.
Configuring via mcp.json
- Launch Cursor application on your (Mac/Windows).
- Invoke the Command Palette with
âK(Mac) orCtrl+Shift+P(Windows). - Search for and select: Settings â Cursor Settings.
- In the Settings sidebar, search and navigate to:
Tools & MCP - On the Tools & MCP page, you will be able to see a button named:
New MCP serverClick on it. - When you click on the New MCP Server button, the
mcp.jsonfile will be opened automatically. - Now, in the
mcp.jsonfile, you will see the âmcpServersâ object. Add the following section inside the âmcpServersâ object:
- Change
your_mcp_server_nameto the name you want to give your MCP server. e.g.,Alchemyst. - Change
YOUR_ALCHEMYST_PLATFORM_API_KEYto your own key, which you will get after logging into the Alchemyst Platform. - Now, save the file and navigate back to the
Tools & MCPpage inside the Cursor settings. - Here, you will be able to see your added MCP Server.
- 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.
- If so, then congratulations to you. Your Cursor is now integrated with Alchemyst AI.
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 |
| 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 |

