MCP Quickstart

Connect Claude Code or Cursor to the Alphacast MCP server in three steps and run your first prompt.

The Alphacast MCP server is an npm package (@alphacast/mcp) that your client runs as a local subprocess via npx. It communicates over stdio and requires Node.js 18+.

1. Get your API key

   Sign in to alphacast.io and generate a new key (or copy an existing one). The same key you use for the REST API works for the MCP server.

   Treat the key like a password. It grants the same permissions as your account. Store it in a secrets manager or an environment variable, not in source control.

2. Add the server to your client

   Run the command for your client. The example below uses Claude Code.

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

   For Claude Desktop, Cursor, and others, see the configuration guides.

3. Run your first prompt

   Restart the client so it picks up the new server, then try a prompt that uses one of the tools:

   “List my Alphacast repositories.”

   The client should call list_repositories and display the result. If you see an authentication error, double-check that the ALPHACAST_API_KEY environment variable is set correctly in step 2.

What’s next

Tools reference

Browse all 32 tools and their input schemas.

Examples

See full prompts that combine search, download, and provider tools.