# AgentCrew

> Chat application with multi-agents system supports multi-models and MCP

- **Type:** MCP server
- **Install:** `agentstack add mcp-saigontechnology-agentcrew`
- **Verified:** Pending review
- **Seller:** [saigontechnology](https://agentstack.voostack.com/s/saigontechnology)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [saigontechnology](https://github.com/saigontechnology)
- **Source:** https://github.com/saigontechnology/AgentCrew
- **Website:** https://agentcrew.dev

## Install

```sh
agentstack add mcp-saigontechnology-agentcrew
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

AgentCrew

  Your team of AI specialists for coding, research, and automation.
  Run multiple focused agents from a desktop app, terminal, or API.

  
  
  
  
  

---

## What is AgentCrew?

AgentCrew lets you build and run a **team of specialized AI agents** instead of
relying on a single generic assistant.

- Give each agent a role — architect, coder, researcher, reviewer, or browser
  operator.
- Agents can hand off work to teammates when a task fits their specialty.
- Use the same team in a desktop GUI, terminal, automated jobs, or over HTTP.

**[Watch the demo](https://github.com/user-attachments/assets/32876eac-b5e6-4608-bd5e-82d6fa4db80f)**

---

## Quick Start

### 1. Install

**macOS / Linux**

```bash
curl -LsSf https://agentcrew.dev/install.sh | bash
```

**Windows**

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://agentcrew.dev/install.ps1 | iex"
```

**pip (any platform)**

```bash
pip install agentcrew-ai
```

### 2. Add an API key

AgentCrew needs at least one AI provider key. Pick your preferred provider and
add the key:

**Option A — Environment variable**

```bash
export ANTHROPIC_API_KEY="sk-ant-..."
# or
export OPENAI_API_KEY="sk-proj-..."
# or
export GEMINI_API_KEY="AIza..."
```

**Option B — Config file**

```bash
mkdir -p ~/.AgentCrew
cat > ~/.AgentCrew/config.json  **Tip:** Not sure which provider to pick? Claude and OpenAI work great for
> most users. See [CONFIGURATION.md](CONFIGURATION.md) for provider-specific
> setup details.

### 3. Launch AgentCrew

```bash
# Desktop GUI
agentcrew chat

# Terminal mode
agentcrew chat --console
```

On the first launch, AgentCrew will walk you through creating your first agent
if you do not already have one.

### 4. Create your first agent

If you already have an API key set and want to create a new agent from scratch:

```bash
agentcrew create-agent
```

Or define one manually in `~/.AgentCrew/agents.toml`:

```toml
[[agents]]
name = "CodeAssistant"
description = "Helps write and review code"
tools = ["code_analysis", "file_editing", "web_search", "memory"]
system_prompt = """You are an expert software engineer.
Focus on code quality, security, and maintainability.
Today is {current_date}."""
```

### 5. Start working

Switch between agents, attach files, and let your team handle the rest.

```
/agent Architect
Design a clean API for a task manager.

@Coding
Implement the task manager in Python using FastAPI.

@Reviewer
Review the code for security issues.
```

---

## Ways to Use AgentCrew

| Mode              | Command                                                     | Best for                                                    |
| ----------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
| **Desktop GUI**   | `agentcrew chat`                                            | Daily interactive work, file drag-and-drop, visual diffs    |
| **Terminal**      | `agentcrew chat --console`                                  | Remote servers, low-overhead use, keyboard-driven workflows |
| **One-shot jobs** | `agentcrew job --agent "CodeAssistant" "your task" ./files` | CI/CD scripts, automation, batch processing                 |
| **HTTP API**      | `agentcrew a2a-server`                                      | Integrating with other apps, multi-instance setups          |

**Job mode example:**

```bash
agentcrew job --agent "CodeAssistant" \
  "Review for security issues" \
  ./src/**/*.py
```

**A2A server example:**

```bash
agentcrew a2a-server --host 0.0.0.0 --port 41241
```

---

## What Can Agents Do?

Agents come with a toolkit you enable per agent:

- **Code analysis** — understand repo structure, read files, grep, search
- **File editing** — write or modify files with search/replace blocks and
  backups
- **Web search & extraction** — pull current information from the web
- **Browser automation** — navigate, click, fill forms, and capture screenshots
- **Command execution** — run safe shell commands with rate limits and audit
  logs
- **Memory** — remember past conversations and retrieve relevant context
- **Voice** — speak and listen using ElevenLabs or DeepInfra (optional)
- **MCP tools** — connect to external services via the Model Context Protocol
- **Structured output** — enforce JSON schema responses in job mode

---

## Example Agent Configurations

See the [`examples/agents/`](examples/agents/) folder for ready-to-use agent
setups. To use an example:

```bash
cp examples/agents/agents.simple.toml ~/.AgentCrew/agents.toml
agentcrew chat
```

---

## Configuration Files

AgentCrew stores settings in `~/.AgentCrew/`:

| File               | Purpose                                  |
| ------------------ | ---------------------------------------- |
| `config.json`      | API keys, theme, global preferences      |
| `agents.toml`      | Agent definitions, tools, system prompts |
| `mcp_servers.json` | External tool servers (optional)         |

You can edit these files directly or manage them through the GUI settings panel.

---

## Common Console Commands

Inside the chat interface, type:

- `/agent ` — switch to another agent
- `/clear` — start a new conversation
- `/file ` — attach a file
- `/copy` — copy the last response
- `/think ` — enable reasoning mode
- `/voice` — start voice recording
- `/help` - show all available commands
- `exit` or `quit` — close AgentCrew

---

## Next Steps

- **[CONFIGURATION.md](CONFIGURATION.md)** — Detailed setup for providers,
  agents, MCP servers, and advanced options
- **[CONTRIBUTING.md](CONTRIBUTING.md)** — How to build and contribute to
  AgentCrew
- **[Docker guide](docker/DOCKER.md)** — Running AgentCrew in containers

---

## License

Apache 2.0 License. See [LICENSE](LICENSE) for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [saigontechnology](https://github.com/saigontechnology)
- **Source:** [saigontechnology/AgentCrew](https://github.com/saigontechnology/AgentCrew)
- **License:** Apache-2.0
- **Homepage:** https://agentcrew.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-saigontechnology-agentcrew
- Seller: https://agentstack.voostack.com/s/saigontechnology
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.