Get the FREE Ultimate OpenClaw Setup Guide →

agent-builder

An example agent demonstrating streaming, tool use, and interactivity from your terminal. This agent builder can help you to build your own agents and tools.

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio strands-agents-agent-builder python -m strands_agents_builder \
  --env STRANDS_KB_ENABLED="true to enable Knowledge Base integration (if applicable)" \
  --env STRANDS_AGENT_BUILDER_LOG_LEVEL="Set to debug or info to control logging verbosity"

How to use

Strands Agent Builder is a Python-based command-line tool that helps you design, test, and deploy custom AI agents and tools in a streamlined workflow. It provides an interactive CLI for building specialized tools, composing agents from those tools, and orchestrating tool workflows with a focus on rapid iteration and hot-reloading during development. The built-in tool set includes capabilities for shell operations, HTTP requests, code editing actions, memory persistence, tool loading, knowledge base integration, and more, enabling you to prototype complex agent systems directly from the terminal. You can create new tools, load additional tools at runtime, and assemble agents that can delegate tasks to nested agents or coordinate multiple agents in a swarm-like setup. The result is a model-driven approach to agent development, where you describe desired capabilities and flows, then let Strands Agent Builder generate and test the corresponding tooling and agent logic.

To use it, install the package via the recommended installer, then run the interactive mode or pass a specification to build a tool or agent. The tool supports knowledge base integration for persisting and loading tools and configurations, making it suitable for long-running experiments and deployment scenarios. The available commands and tools span a wide range of tasks—from shell and HTTP interactions to Python code execution, image generation, and structured knowledge-base operations—allowing you to prototype sophisticated agent workflows without writing all boilerplate code from scratch.

How to install

Prerequisites:

  • Python 3.8+ installed on your system
  • PIP or an equivalent Python package manager
  • Optional: a knowledge base setup if you plan to use Bedrock-powered storage

Install using pipx (recommended for isolation and easy updates):

pipx install strands-agents-builder

Alternatively, install directly with Python's package manager:

pip install strands-agents-builder

Run the interactive mode to start building agents and tools:

strands

If you prefer to run it as a module directly (e.g., in CI or an environment without pipx):

python -m strands_agents_builder

Prerequisites recap:

  • Ensure Python is available on PATH
  • Ensure network access to fetch the package from PyPI
  • If using Bedrock features, configure AWS credentials and Bedrock access as needed

Additional notes

Tips and known considerations:

  • The builder ships with a large set of built-in tools (e.g., shell, HTTP requests, editor, memory management, tool loading, and more). Review the Integrated Tools list to understand capabilities and any platform-specific limitations (e.g., some tools may be unavailable on Windows).
  • Knowledge Base integration can be leveraged to persist tools, configurations, and history. Follow the KB setup sections if you plan to store and reuse tools across sessions.
  • For development workflows, take advantage of hot-reloading during tool development to iterate quickly.
  • Environment variables can customize behavior (e.g., log verbosity, enabling/disabling KB features). Use them to tailor the runtime to your environment.
  • If you encounter permission or AWS/Bedrock-related issues, verify IAM roles, permissions, and region configurations used by any KB features.

Related MCP Servers

Sponsor this space

Reach thousands of developers