Skip to main content
Connect your AI coding assistant to Asteroid in under a minute. The same MCP server works with any editor that supports the Model Context Protocol.

​
Prerequisites

  • An Asteroid account with an API key (generate one here)
  • Claude Code or Cursor (or any MCP-compatible editor)

​
Claude Code

1

Add the MCP server

Run this command in your terminal:
claude mcp add --transport http asteroid https://mcp.asteroid.ai/mcp
This registers the Asteroid MCP server with Claude Code.
2

Authenticate

The first time Claude Code calls an Asteroid tool, you’ll be prompted to provide your API key. You can also set it as an environment variable:
export ASTEROID_API_KEY="ast_..."
3

Verify the connection

Ask Claude Code to list your agents:
"List all my Asteroid agents"
If the connection is working, you’ll see your agents listed in the response.

​
Cursor

1

Add the MCP server config

Add the following to your .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
  "mcpServers": {
    "asteroid": {
      "url": "https://mcp.asteroid.ai/mcp"
    }
  }
}
2

Authenticate

As with Claude Code, provide your API key when prompted or set the ASTEROID_API_KEY environment variable.
3

Verify the connection

In Cursor’s AI chat, ask:
"List all my Asteroid agents"
Any editor that supports MCP can connect to the Asteroid server at https://mcp.asteroid.ai/mcp using the HTTP transport. The setup steps will be similar — register the server URL and provide your API key.

​
Usage Examples

Once connected, you can interact with Asteroid using natural language. Here are some common tasks:

​
Inspecting executions

"What happened in execution abc123-def4-..."
"Show me the last 10 executions for my scraping agent"
"Why did execution abc123 fail?"
"List all failed executions from today"

​
Managing workflows

"Fetch the current workflow for agent abc123-..."
"Add a new input called 'language' to the agent workflow"
"Update the output schema to include a 'confidence' field"
"Publish the new workflow version"

​
Starting executions

"Run agent abc123 with url=https://example.com and name=Test"

​
Debugging

"Show me the activity log for execution abc123"
"What tool calls did the agent make in execution abc123?"
"What was the agent's reasoning for the outcome?"

​
Troubleshooting

ProblemSolution
”Tool not found” errorsVerify the MCP server is registered — run claude mcp list (Claude Code) or check .cursor/mcp.json (Cursor)
Authentication failuresCheck that your ASTEROID_API_KEY is valid and not expired. Generate a new key at platform.asteroid.ai/keys
Timeout errorsThe MCP server connects to the Asteroid API — ensure you have internet access and no firewall blocking mcp.asteroid.ai
Need help? Visit our Support page or reach out on GitHub.