@aithr-ai/mcp-server

MCP (Model Context Protocol) server to connect Claude Code to the Aether canvas.

Quick Install

Mac/Linux

claude mcp add --transport stdio aether \
  --env AETHER_API_KEY=YOUR_KEY \
  --env AETHER_WORKSPACE_ID=your-workspace \
  --env AETHER_PROJECT_ID=your-project-id \
  -s user -- npx -y @aithr-ai/mcp-server

Windows

Add this to your ~/.claude.json file (in the mcpServers object):

{
  "mcpServers": {
    "aether": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@aithr-ai/mcp-server"],
      "env": {
        "AETHER_API_KEY": "YOUR_KEY",
        "AETHER_WORKSPACE_ID": "your-workspace",
        "AETHER_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Note: The claude mcp add command has a bug on Windows that drops the command args. Manual config is required.

Get Your Credentials

Visit https://www.aithr.ai/settings/mcp-install for personalized install commands with your API key and project ID.

Available Tools

Canvas Management

• aether_canvas_state - Get current canvas state
• aether_clear_canvas - Clear all nodes from canvas
• aether_add_agent - Add an AI agent to the canvas
• aether_remove_node - Remove a node
• aether_connect_nodes - Create connections between nodes
• aether_list_agents - List all agents on canvas

Generation

• aether_trigger_generation - Trigger AI generation for an agent
• aether_get_artifacts - Get generated artifacts

GitHub Automation

• aether_automation_status - Check what's ready to push
• aether_extract_files - Extract code from artifacts
• aether_push_artifacts - Push to GitHub via API (branch + commit + PR)
• aether_push_local - NEW Push using local git (no rate limits, recommended for large pushes)

Orchestra (Autonomous Development)

• aether_start_orchestra - Start orchestration session
• aether_set_orchestra_plan - Define development plan
• aether_orchestra_approve - Approve and start execution
• aether_orchestra_status - Get progress and status
• aether_orchestra_next - Get next ready tasks
• aether_orchestra_trigger_task - Execute a specific task
• aether_report_to_orchestrator - Report completion/blockers
• aether_orchestra_pause / aether_orchestra_resume - Control execution
• aether_complete_orchestra - Mark session complete
• aether_orchestra_set_autonomous - Enable/disable autonomous mode

Folders & Artifacts

• aether_list_folders - List project folders
• aether_create_folder - Create a folder
• aether_delete_folder - Delete a folder
• aether_add_file_to_folder - Add files to folders
• aether_create_artifact - Create and place artifacts

Orchestra Skill (Auto-Installed)

When you install this package, it automatically installs the Orchestra skill to your Claude Code skills directory (~/.claude/skills/orchestra/).

This enables the /orchestra command with full v6 capabilities:

/orchestra          # Start planning a new session
/orchestra approve  # Begin autonomous execution
/orchestra status   # Check current progress
/orchestra push     # Push to GitHub

Orchestra v6 Features

• Contract-First Development - Define types, schemas, APIs upfront
• Orchestrator Brain - AI-powered decision engine (Claude Opus 4.5)
• Dynamic Agent Switching - Reassign tasks when agents struggle
• Structured Reports - Consistent agent-to-orchestrator communication
• File Collision Prevention - Safe parallel task execution with file locks
• Validation Protocol - TypeScript checks after every code generation

Manual Skill Installation

If the auto-install doesn't work, manually copy the skill:

# The skill file is bundled at:
# node_modules/@aithr-ai/mcp-server/skills/orchestra/SKILL.md

# Copy to your Claude skills directory:
mkdir -p ~/.claude/skills/orchestra
cp node_modules/@aithr-ai/mcp-server/skills/orchestra/SKILL.md ~/.claude/skills/orchestra/

Documentation

Full documentation at https://www.aithr.ai/docs/orchestra