Introduction • Installation • Hacking Edition • How to update • Documentation • Usage

Introduction

This repository showcases the powerful integration of Agent Zero with XPack.AI, demonstrating how you can extend the capabilities of your AI agent by connecting to thousands of ready-to-use tools worldwide. Building upon the robust foundation of Agent Zero - a personal, organic agentic framework that grows and learns with you - this project provides a practical example of configuring its Model Context Protocol (MCP) service to leverage XPack's extensive service marketplace.

What is Agent Zero?

Agent Zero is a personal, organic agentic framework designed to be dynamic, organically growing, and learning as you use it. Unlike predefined agentic frameworks, Agent Zero is fully transparent, readable, comprehensible, customizable, and interactive. It uses the computer as a tool to accomplish its (your) tasks.

Key Features:

• General-purpose Assistant: Not pre-programmed for specific tasks but meant to be a versatile personal assistant
• Computer as a Tool: Uses the operating system to create and use its own tools as needed
• Multi-agent Cooperation: Every agent can create subordinate agents to break down and solve subtasks
• Completely Customizable: Almost nothing is hard-coded; everything can be extended or changed
• Persistent Memory: Memorizes previous solutions, code, facts, and instructions for faster future problem-solving
• MCP Server & Client Support: Can act as an MCP Server for other LLM tools and use external MCP servers

What is XPack.AI?

XPack.AI is a platform that enables AI agents to connect to a vast ecosystem of global services and tools through a unified Model Context Protocol (MCP). With XPack, you can effortlessly expand your AI agent's functionalities, accessing diverse APIs and services across various domains like finance, logistics, messaging, and more, all in under a minute.

Agent Zero + XPack: Bridging AI with Global Services

This project focuses on demonstrating how to configure Agent Zero to utilize XPack as an MCP server. By doing so, your Agent Zero instance gains immediate access to XPack's rich collection of tools, allowing you to:

• Access a diverse range of services: From financial data to image processing, integrate capabilities that were previously out of reach
• Accelerate development: Rapidly prototype and build AI-powered solutions by leveraging pre-built tools
• Streamline workflows: Automate complex tasks by combining Agent Zero's intelligence with XPack's external service integrations
• Scale effortlessly: Connect to thousands of global services without writing custom integration code

Architecture Overview

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   User Input    │    │   Agent Zero     │    │   XPack.AI      │
│   (Web/CLI)     │◄──►│                  │◄──►│   Marketplace   │
└─────────────────┘    │  ┌─────────────┐ │    │                 │
                       │  │ MCP Client  │ │    │  ┌─────────────┐│
┌─────────────────┐    │  │             │ │    │  │1000+ Global ││
│  Local Tools    │◄──►│  │ • XPack     │ │    │  │Services     ││
│  & Resources    │    │  │ • Local     │ │    │  │• Finance    ││
└─────────────────┘    │  │ • Custom    │ │    │  │• Social     ││
                       │  └─────────────┘ │    │  │• Data       ││
┌─────────────────┐    │  ┌─────────────┐ │    │  │• AI/ML      ││
│  Multi-Agent    │◄──►│  │   Agent     │ │    │  │• Utilities  ││
│  Cooperation    │    │  │Orchestration│ │    │  └─────────────┘│
└─────────────────┘    │  └─────────────┘ │    └─────────────────┘
                       └──────────────────┘

Key Components:

• Agent Zero Core: Orchestrates tasks and manages multi-agent cooperation
• MCP Client: Standardized interface for connecting to external tool providers
• XPack MCP Server: Gateway to 1000+ global services via unified API
• Local Tools: Built-in capabilities like code execution, file system access
• Multi-Agent System: Collaborative AI agents working together to solve complex tasks

Quickstart

Install Agent Zero

First, ensure Agent Zero is installed. Please follow the installation steps in the Installation section below if you haven't already.

⚡ Quick Start with Docker:

# Pull and run with Docker
docker pull frdel/agent-zero-run
docker run -p 50001:80 frdel/agent-zero-run

# Visit http://localhost:50001 to start

Configure XPack MCP

To connect your Agent Zero to XPack, you need to configure an MCP server. This allows Agent Zero to discover and utilize the tools available through XPack.

1. Obtain your XPack Auth Key:

• Visit XPack.AI and sign up for an account
• Generate your Auth key from your XPack dashboard

2. In Agent Zero Configuration

Option A: Through Agent Zero Settings UI (Recommended)

Configure MCP through Settings UI:

• Open Agent Zero web interface at http://localhost:50001

• Navigate to the Settings page (⚙️ Setting)

• Switch to the MCP tab and open the MCP Server Configuration

• In the MCP Servers section, add the following configuration:

  {
    "mcpServers": {
      "xpack-mcp-market": {
        "type": "sse",
        "url": "https://mcp.xpack.ai/v1/mcp?apikey={YOUR_XPACK_AUTH_KEY}",
        "name": "XPack MCP Market",
        "description": "Access to 1000+ global services through XPack.AI marketplace"
      }
    }
  }

  

Option B: Manual Configuration

If you prefer manual configuration, edit tmp/settings.json directly. The MCP servers configuration should be a JSON string in the mcp_servers field:

{
  "mcp_servers": "{\n  \"mcpServers\": {\n    \"xpack-mcp-market\": {\n      \"type\": \"sse\",\n      \"url\": \"https://mcp.xpack.ai/v1/mcp?apikey={YOUR_XPACK_AUTH_KEY}\",\n      \"name\": \"XPack MCP Market\",\n      \"description\": \"Access to 1000+ global services through XPack.AI marketplace\"\n    }\n  }\n}"
}

⚠️ Replace YOUR_XPACK_AUTH_KEY with your actual XPack Auth key from the dashboard.

Configuration Detail

• Server Name: xpack-mcp-market - This identifies the XPack MCP server
• Type: sse - Server-Sent Events connection type for real-time communication
• URL: XPack's MCP endpoint with your authentication key
• Capabilities: Access to 1000+ global services through standardized MCP interface

For detailed MCP configuration instructions, see our MCP Setup Guide.

3. Run Agent Zero with MCP

Once the configuration is complete, restart Agent Zero. It will automatically connect to the XPack MCP server and discover available tools.

Verifying Configuration

To verify that XPack MCP is properly configured:

1. Check Agent Zero logs for MCP connection messages:

   MCPClientBase (xpack_mcp_market): Tools updated. Found 4 tools.
   

2. Test in the web interface by asking:

   What is xpack-mcp-market
   

3. Try a simple task:

   Use XPack tools to check the current weather in New York
   

   

If configured correctly, Agent Zero will show available XPack tools and be able to use them for various tasks.

Usage

You can then input your ideas and prompts in the terminal or web UI, and Agent Zero will leverage the tools from XPack to accomplish the tasks. Simply mention "use XPack" or "use xpack-mcp-market" in your requests to specifically utilize XPack services.

Popular Tasks

This section provides practical examples of how you can leverage Agent Zero with XPack for various tasks.

Analyze YouTube comments and provide suggestions to improve video creation

Easily analyze YouTube video comments to understand audience sentiment and get suggestions for improving your content.

Please use xpack to read the comments on this YouTube video: https://www.youtube.com/watch?v=LPZh9BOjkQs, analyze the sentiment of the feedback, and recommend improvements for the video.

Current Gold Price and Influencing Factors

Quickly check the latest gold price and discover key factors that may affect future trends.

Please use xpack to look up the current real-time price of gold and provide specific factors that may impact its price in the future.

Generate a Running Puppy Image

Easily create adorable custom images using AI image generation tools through XPack.

Generate a running puppy image with xpack

---

Ready to supercharge your Agent Zero with global services? Get started with XPack.AI today and unlock the full potential of agentic AI!