Skip to main content

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:
"your_mcp_server_name": {
      "url": "https://mcp.getalchemystai.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_ALCHEMYST_PLATFORM_API_KEY"
      }
    }
  1. Change your_mcp_server_name to the name you want to give your MCP server. e.g., Alchemyst.
  2. Change YOUR_ALCHEMYST_PLATFORM_API_KEY to your own key, which you will get after logging into the Alchemyst Platform.
  3. Now, save the file and navigate back to the Tools & MCP page inside the Cursor settings.
  4. Here, you will be able to see your added MCP Server.
  5. 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.
  6. If so, then congratulations to you. Your Cursor is now integrated with Alchemyst AI.
Your Alchemyst MCP server is now live inside Cursor!

Troubleshooting

IssuePossible CauseFix
MCP toggle is missingOutdated Cursor versionUpdate Cursor to the latest version
SSE connection failsNetwork restrictions or firewallAllow outbound access to https://mcp.getalchemystai.com
”Authorization failed”Incorrect or expired API keyRegenerate your API key from Alchemyst Dashboard
MCP server not appearingmcp.json not formatted correctlyValidate your JSON syntax
No context syncingMCP service not startedClick Start beside the MCP server entry in Cursor