Install the MCP server

The MCP server signs you in through the browser. It does not take an API key.

Claude Code
Cursor

Add the server

Run this in your terminal:

claude mcp add --transport http asteroid https://mcp.asteroid.ai/mcp

Complete the browser sign-in the first time Claude Code calls an Asteroid tool. The client stores the token and sends it on later requests.

Check it works

Ask Claude Code:

List all my Asteroid agents

Your workflows come back in the reply.

Add the server

Add this to .cursor/mcp.json in the project, or to ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "asteroid": {
      "url": "https://mcp.asteroid.ai/mcp"
    }
  }
}

Accept the OAuth prompt on first use so Cursor gets a token for your Asteroid user.

Check it works

In the chat, ask:

List all my Asteroid agents

The server speaks streamable HTTP at /mcp. It publishes OAuth metadata at /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server, so clients that discover authentication find it on their own.

When it does not connect

Problem	Fix
”Tool not found”	Check the server is registered. Run `claude mcp list`, or read `.cursor/mcp.json`.
401 or an authentication error	Remove the server, add it again, and sign in. Check your user has access to the organization.
Timeouts	Check your network reaches `mcp.asteroid.ai`.

Give your coding agent skill.md too, so it can act on these docs directly. See Point your coding agent at the docs.

What the MCP server can do

Every tool, grouped by what it acts on

Build a workflow over MCP

A worked example, start to finish

Get Started

Reference

When it does not connect

Next

What the MCP server can do

Build a workflow over MCP

​When it does not connect

​Next

What the MCP server can do

Build a workflow over MCP

When it does not connect

Next