Skip to main content
This guide explains two integration methods:
  1. HTTP / Server-Sent Events (recommended)
  2. Direct configuration via settings.json
MCP now uses OAuth 2.1 — just add the server URL. VS Code 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 the config is needed (direct Bearer header still works as fallback).

Prerequisites

Before proceeding, ensure that:
  • You have Visual Studio Code v1.101+ installed.
  • You have a valid Alchemyst Platform API key (paste once at OAuth login).
  • Your VS Code supports MCP integration (either via the OpenAI MCP extension or natively if available).
  • You are familiar with editing VS Code’s settings.json

1. Integration via HTTP (Server-Sent Events)

  1. Open Command Palette via: Ctrl (or Cmd) + Shift + P.
  2. Type MCP and select MCP: Add Server....
  3. Choose HTTP (HTTP or Server-Sent Events) as the transport type.
  4. Enter the URL: https://mcp.getalchemystai.com/mcp
  5. Select Server ID: This is going to be your server name. e.g., Alchemyst-server-mcp.
  6. Then, you will be asked to choose whether to save settings at User-level settings.json or Workspace level.
  7. VS Code will trigger OAuth discovery and open https://mcp.getalchemystai.com/auth/login — paste your Alchemyst API key there once to verify. No headers edit is needed. Fallback without OAuth: add "headers": { "Authorization": "Bearer YOUR_ALCHEMYST_PLATFORM_API_KEY" }.
  8. You will see a faint Start button popping right up on top of the MCP object in your present settings.json file.
  9. Click on that and your MCP server will be ready to use!
You’re done! Your MCP server is now connected via HTTP (SSE) with OAuth.

2. Configuration via settings.json

  1. Open Command Palette
    • Press Ctrl (or Cmd) + Shift + P.
    • Type and select “Preferences: Open User Settings (JSON)”.
  2. Now, you are in User Settings JSON.
  3. Add the following MCP Configuration block.
OAuth will open a browser login to verify your API key. Fallback: add "headers": { "Authorization": "Bearer YOUR_ALCHEMYST_PLATFORM_API_KEY" } inside the server object.
  1. Save your settings.json file.
  2. You will see a faint Start button popping right up on top of the MCP object in your present settings.json file.
  3. Click on that and your MCP server will be ready to use!
You’re done! Your MCP server is now connected via directly configuring the settings.json file.

Troubleshooting