Connect Claude Code

Add the Alphacast MCP server to Claude Code — the hosted server over OAuth, or the local npm package via npx.

Claude Code supports both transports. Use the hosted server (no install, OAuth login) or the local npm package (spawned via npx).

Hosted (remote, OAuth)

Add the remote server with the HTTP transport — no Node.js or API key required:

claude mcp add --transport http alphacast https://mcp.alphacast.io/mcp

The first time you use it, authorize the connection: run /mcp, select alphacast, and choose Authenticate. Claude Code opens your browser to sign in with your Alphacast account and stores the token for you.

To remove it later:

claude mcp remove alphacast

Add --scope project to share a checked-in .mcp.json with collaborators (each person still authenticates with their own Alphacast account — no secret is committed):

.mcp.json

{
  "mcpServers": {
    "alphacast": {
      "type": "http",
      "url": "https://mcp.alphacast.io/mcp"
    }
  }
}

Local (npm package)

Claude Code launches the Alphacast MCP server as a local subprocess via npx. You can add it with a single CLI command, or by editing the project-level .mcp.json file.

CLI (recommended)

Run this from any directory inside your project. The server is added at the user scope by default — pass --scope project to share it with collaborators via a checked-in .mcp.json.

claude mcp add alphacast -e ALPHACAST_API_KEY=YOUR_API_KEY -- npx -y @alphacast/mcp

To remove it later:

claude mcp remove alphacast

To list configured servers and their status:

claude mcp list

.mcp.json (project-scoped, checked into the repo)

If you want the server available to anyone who clones the project, create or edit .mcp.json at the repo root:

.mcp.json

{
  "mcpServers": {
    "alphacast": {
      "command": "npx",
      "args": ["-y", "@alphacast/mcp"],
      "env": {
        "ALPHACAST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Do not commit a real API key to a project-scoped .mcp.json. Use an environment variable reference (e.g. "ALPHACAST_API_KEY": "${ALPHACAST_API_KEY}") and document the variable in your project README.

Verify

Open a new Claude Code session and run:

/mcp

The alphacast server should appear with 32 tools and a green connected status. If it shows red, run claude mcp list to inspect the configured command and environment.

Try a prompt that hits a read-only tool to confirm the connection end-to-end:

“Use the alphacast MCP to list my repositories.”