Skip to main content
MCP now uses OAuth 2.1 — add just the server URL; Cursor will open a browser login where you paste your Alchemyst API key once to verify and get a short-lived token. No API key in mcp.json is needed (direct Bearer header still works as fallback).

​
Prerequisites

Before starting, make sure you have:
  • Visual Studio Code v1.101+ installed.
  • A valid Alchemyst Platform API key (you’ll paste it once at login).
  • 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:
  1. Change your_mcp_server_name to the name you want to give your MCP server. e.g., Alchemyst.
  2. Save — Cursor will trigger OAuth discovery and open https://mcp.getalchemystai.com/auth/login. Paste your Alchemyst API key there once to verify (create one at Alchemyst Platform if needed). Fallback without OAuth: add "headers": { "Authorization": "Bearer YOUR_ALCHEMYST_PLATFORM_API_KEY" }.
  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