Skip to main content
Claude Desktop launches MCP servers as local processes defined in claude_desktop_config.json. The Alphacast MCP server runs via npx and communicates over stdio.
npx ships with Node.js. If npx is not found, install Node 18 or later from nodejs.org. On a corporate machine without admin rights, see Install Node.js without admin rights.
1

Get your API key

Sign in to Alphacast and open Settings. Copy your API key. If you belong to multiple teams, make sure your active team subscription is selected first — the key inherits that team’s permissions.
2

Open the config file

The most reliable way — it works no matter where Claude Desktop is installed:
  1. In Claude Desktop, open your profile → SettingsDeveloper.
  2. Click Edit Config. This opens the folder containing claude_desktop_config.json.
  3. Open claude_desktop_config.json in any text editor.
For reference, the standard locations are:
OSPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Enterprise deployments of Claude Desktop may use a different directory (for example %LOCALAPPDATA%\Claude-3p\ on Windows). If the standard path doesn’t exist on your machine, use the Edit Config button above, or search for claude_desktop_config.json with Windows Search.
3

Add the server

If the file is empty or doesn’t exist, paste this entire block (replace YOUR_API_KEY with your key):
claude_desktop_config.json
{
  "mcpServers": {
    "alphacast": {
      "command": "npx",
      "args": ["-y", "@alphacast/mcp"],
      "env": {
        "ALPHACAST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
If the file already has content (other MCP servers or settings), add the alphacast entry inside the existing mcpServers object — don’t paste the whole block again:
claude_desktop_config.json
{
  "mcpServers": {
    "some-other-server": {
      "command": "..."
    },
    "alphacast": {
      "command": "npx",
      "args": ["-y", "@alphacast/mcp"],
      "env": {
        "ALPHACAST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
The most common failure at this step is invalid JSON: a missing comma between server entries, an extra trailing comma, or unbalanced braces. If Claude Desktop silently ignores your server after a restart, the JSON is almost certainly malformed. Quick fix: paste the full file content into a Claude chat and ask it to find and fix the JSON error.
When saving on Windows, if your editor offers Save As, set “Save as type” to All Files so the file isn’t saved as claude_desktop_config.json.txt.
4

Restart Claude Desktop

Quit Claude Desktop completely — right-click the menu bar / system tray icon and choose Quit. Closing the window is not enough; the app keeps running in the background and won’t reload the config. Then relaunch it.
5

Verify it actually works

The “running” badge next to the server in Settings → Developer is not proof that the server works. It can show “running” even when the server failed to start or authenticate. Always verify in the chat itself.
  1. Open a new chat and click the tools menu (the slider icon). You should see the alphacast server listed with its 32 tools enabled.
  2. Send a test prompt:
    “List my Alphacast repositories.”
  3. Confirm that Claude calls a tool — you’ll see a list_repositories tool-call block in the response. If Claude answers from general knowledge with no tool call (and no tools icon appears), the server is not actually connected, even if the Developer tab says “running”.
If verification fails, open Settings → Developer → Open MCP Logs — the logs are the only reliable way to diagnose a failed server. What to look for:
Log messageCauseFix
npx not found / spawn errorNode.js missing or not on PATHInstall Node.js or use the full path to npx.cmd
401 UnauthorizedInvalid or missing API keyAuthentication errors
JSON parse error / server missing entirelyMalformed config fileFix the config JSON

Next steps

Troubleshooting

Setup, authentication, and connection fixes — including enterprise Windows environments.

Examples

Full prompts that combine search, download, and provider tools.