Skip to main content

​
Overview

BLACKBOX AI MCP (Model Context Protocol) enables direct interaction with remote agents through the Blackbox CLI in your terminal. This integration allows you to assign tasks, monitor progress, retrieve execution details, and control remote agents effortlessly from the command line. By connecting your CLI to the Blackbox Cloud MCP server, you gain the full power of remote agents without leaving your development environment. Start Task The MCP integration enables the CLI agent to orchestrate multiple sub-tasks and parallel tasks, including creation, stopping, merging changes, and coordinating remote agents to achieve final goals. This feature is ideal for developers who prefer terminal workflows, enabling natural language commands to manage tasks, query agent capabilities, and execute complex operations on remote repositories.

​
Getting Started

To set up MCP integration with Blackbox Cloud, follow these steps:
  1. Access MCP Token Section
    Navigate to cloud.blackbox.ai, log in, and go to your profile settings. Locate the “MCP Token” section.     MCP Token Section
  2. Generate or Regenerate Token
    Click the generate button to create a new MCP token or regenerate an existing one for security.     Generate Token
  3. Copy the Command
    Copy the pre-generated command or use the token in the following format. This command connects your Blackbox CLI to the MCP server.     Token Command View
  4. Connect MCP Server in Terminal
    Open your terminal and run the command you have copied from MCP Setup Command or the following command:     
    blackbox mcp add remote-code https://cloud.blackbox.ai/api/mcp -t http -H "Authorization: Bearer <Your_Token_here>"
    Replace <Your_Token_here> with your actual token. Add MCP Command
  5. Verify Connection
    Start a new Blackbox CLI instance by running blackbox. You should see “using 1:MCP server” in the terminal, indicating a successful connection.     MCP Connected
With the MCP server connected, you can now interact with remote agents directly from your CLI.

​
How It Works

Once connected, use tools or issue natural language commands in the Blackbox CLI to control remote agents. The MCP integration supports querying tools, managing tasks, executing operations, and much more seamlessly.
  • Explore Available Tools
    Use the keyboard shortcut “Ctrl + t” or simply ask the CLI: "print all the remote-code tools" to list all available tools and their capabilities.     Ask Capabilities
  • View Existing Tasks
    Query your tasks by saying: "Get all my tasks" to retrieve a list of current and past tasks.     Get Tasks
  • Start a New Task
    Initiate tasks naturally, e.g., "Start a new task on test_chat repo on main branch to add a stripe integration to handle payments." Specify the repository and branch in natural language. The task will be created and executed remotely.     Start Task You can verify the same via Blackbox Cloud UI in browser. View Task UI
  • Monitor Task Progress
    Tasks run autonomously on the remote agent. Check status and details via CLI queries or view them in the Blackbox Cloud UI.
This hands-free interaction brings the power of remote agents directly into your terminal workflow.

​
Key Features

  • Terminal-Based Control: Manage remote agents without switching to a browser.
  • Natural Language Commands: Issue tasks and queries conversationally.
  • Real-Time Monitoring: Get live updates on task status and execution details.
  • Seamless Integration: Connects directly to Blackbox Cloud for authenticated access.
  • Tool Discovery: Dynamically list and utilize available remote tools.
  • Task Orchestration: Enable the CLI agent to create or manage remote task(s), orchestrating them to achieve final goals through different tools available.

​
Benefits

  • Terminal-Centric Workflow: Manage remote agents directly from your CLI without switching to a browser, streamlining development for command-line users.
  • Natural Language Interaction: Issue complex tasks and queries using conversational commands, reducing the need for precise syntax or manual inputs.
  • Real-Time Task Oversight: Monitor agent progress and execution details live in your terminal, enabling quick interventions and status checks.
  • Dynamic Tool Utilization: Automatically discover and leverage available remote tools, expanding your CLI’s capabilities without additional setup.
  • Agent Orchestration: Enable the CLI agent to manage and coordinate multiple remote agents, automating task delegation, parallel execution, and sub-task orchestration to achieve complex goals.
  • Context Sharing: Seamlessly share remote agent task details with the CLI, enabling local improvements or continued development without context loss.

​
Use Cases

  • Complex Feature Development: Build full-stack features autonomously via CLI commands, delegating code generation, testing, and integration to remote agents.
  • Parallel Bug Fixes: Orchestrate simultaneous fixes across multiple repositories, executing and merging changes without manual intervention.
  • Automated Code Reviews: Extend CLI capabilities with AI-powered reviews and merges on pull requests, enhancing git workflows.
  • Real-Time Task Monitoring: Track and adjust remote agent progress in real-time, issuing follow-up commands for iterative development.
  • Scalable Project Management: Coordinate subtasks across branches for large-scale refactoring or optimizations using orchestrated remote agents.

​
Next Steps

Explore related Blackbox Cloud features to expand your remote development capabilities:

Blackbox Cloud

Learn about the full remote agent platform.

Blackbox CLI

Dive deeper into terminal-native development.

Multi-Agent Execution

Run multiple agents in parallel.

Slack Integration

Manage tasks via Slack.
MCP integration transforms your CLI into a powerful hub for remote agent control, streamlining workflows and enhancing productivity.