# HexaEight MCP Client
🚀 **Framework-agnostic MCP integration with automatic multi-agent coordination and military-grade encryption.**
Build sophisticated multi-agent systems with minimal code while maintaining complete security and framework choice.
## 🌟 Key Features
- 🔐 **Secure Agent Identity** - Military-grade encryption for agent authentication and communication
- 🤖 **Framework Integration** - AutoGen, CrewAI, LangChain with secure agent coordination
- 🛠️ **Multi-Agent Types** - LLM agents, Tool agents, User agents with automatic coordination
- 🌐 **Automatic Discovery** - Dynamic capability discovery and intelligent message routing
- 📡 **PubSub Coordination** - Seamless agent communication and task delegation
- ⚡ **One-Line Setup** - From configuration to production-ready agents instantly
- 🎯 **Business Logic** - Write your actual API/database code once in tool agents
- 🔒 **Production Security** - Zero plain-text secrets, secure agent identity management
## 📋 Prerequisites
### 1. HexaEight Agentic IAM Server
Deploy from Azure Marketplace to create Client Applications:
- **Azure Marketplace**: [HexaEight Agentic IAM](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam)
- Creates ClientID, Token Server URL, PubSub URL
- Enables secure agent identity management
### 2. Machine License
Purchase and activate on your development machine:
- **License Store**: [store.hexaeight.com](https://store.hexaeight.com)
- Pricing: 1 CPU = $15, 2 CPU = $30, 4 CPU = $60 (minimum 5 days)
- Enables creation of **1 parent configuration** + **unlimited child configurations**
### 3. Mobile App Setup
- Download **"HexaEight Authenticator"** app (iOS/Android)
- Create generic resource (instant) or domain-based resource (branded)
- Used for secure license activation
### Agent Licensing Model
| Agent Type | License Requirement | Expiry Behavior |
|------------|--------------------|-----------------|
| **Parent Agents** | ✅ Active HexaEight license required | ❌ Stop working when license expires |
| **Child Agents** | ✅ Created with valid license | ✅ Continue working after license expires |
## 🚀 Installation
```bash
# Basic installation
pip install hexaeight-mcp-client
# With framework support
pip install hexaeight-mcp-client[autogen] # For AutoGen
pip install hexaeight-mcp-client[crewai] # For CrewAI
pip install hexaeight-mcp-client[langchain] # For LangChain
pip install hexaeight-mcp-client[all] # All frameworks
```
### Prerequisites Installation
```bash
# Core HexaEight agent package
pip install hexaeight-agent
# Optional: Framework packages
pip install pyautogen # For AutoGen integration
pip install crewai # For CrewAI integration
pip install langchain # For LangChain integration
```
## 🎓 Quick Start Guide
### Step 1: Learn the Concepts
```bash
# Interactive presentation of HexaEight AI agent concepts
hexaeight-start show-concepts
# Auto-advancing presentation (no interaction required)
hexaeight-start show-concepts --auto
```
### Step 2: Check Prerequisites
```bash
# Verify system requirements (.NET, dotnet-script)
hexaeight-start check-prerequisites
```
### Step 3: Activate License
```bash
# Clean, focused license activation process
hexaeight-start license-activation
```
### Step 4: Create Development Environment
```bash
# Create organized workspace with license hardlinks
hexaeight-start create-directory-linked-to-hexaeight-license my-ai-project
cd my-ai-project
# Generate parent and child agent configuration files
hexaeight-start generate-parent-or-child-agent-licenses
# Deploy sample multi-agent weather system
hexaeight-start deploy-multi-ai-agent-samples
```
## 🔐 Secure LLM Configuration
### Supported LLM Providers
| Provider | Configuration Example |
|----------|----------------------|
| **OpenAI** | `{"provider": "openai", "api_key": "sk-...", "model": "gpt-4"}` |
| **Azure OpenAI** | `{"provider": "azure_openai", "api_key": "...", "azure_endpoint": "https://..."}` |
| **Anthropic** | `{"provider": "anthropic", "api_key": "sk-ant-...", "model": "claude-3-sonnet"}` |
| **Local Ollama** | `{"provider": "ollama", "base_url": "http://localhost:11434", "model": "llama2"}` |
## 🤖 Framework Integration
### AutoGen Integration
```python
from hexaeight_mcp_client import create_autogen_agent_with_hexaeight
# Create AutoGen agent with secure HexaEight integration
autogen_agent, hexaeight_agent = await create_autogen_agent_with_hexaeight(
config_file="parent_config.json",
agent_type="parentLLM",
name="IntelligentCoordinator",
system_message="You can coordinate with multiple specialized agents and services."
)
# AutoGen agent now has:
# ✅ Secure HexaEight integration
# ✅ HexaEight coordination tools
# ✅ Automatic capability discovery
# ✅ Multi-agent coordination via PubSub
```
### CrewAI Integration
```python
from hexaeight_mcp_client import create_crewai_agent_with_hexaeight
# Create CrewAI agent with secure HexaEight integration
crewai_agent, hexaeight_agent = await create_crewai_agent_with_hexaeight(
config_file="parent_config.json",
agent_type="parentLLM",
role="Multi-Agent Coordinator",
goal="Coordinate complex workflows using available tools and services",
backstory="Expert in orchestrating multi-agent systems with secure communication"
)
```
### LangChain Integration
```python
from hexaeight_mcp_client import HexaEightAutoConfig
from langchain.chat_models import ChatOpenAI
from langchain.agents import initialize_agent
# Create LangChain setup with HexaEight integration
hexaeight_agent = await HexaEightAutoConfig.create_llm_agent(
agent_type="parentLLM",
config_file="parent_config.json",
framework="langchain"
)
# Use with LangChain for secure multi-agent coordination
tools = hexaeight_agent.get_available_tools()
# Integrate with your LangChain LLM of choice
```
## 🛠️ Multi-Agent Architecture
### Agent Types
| Agent Type | Purpose | Verification | Broadcasts | Use Case |
|------------|---------|--------------|------------|----------|
| **parentLLM** | LLM coordination | ✅ Required | ✅ Receives all | Main intelligence and coordination |
| **childLLM** | LLM task execution | ✅ Required | ✅ Receives all | Specialized LLM workers |
| **parentTOOL** | Service provision | ❌ Not required | ❌ Ignores broadcasts | API services, databases |
| **childTOOL** | Specialized services | ❌ Not required | ❌ Ignores broadcasts | Specific tool implementations |
| **USER** | Human interaction | ❌ Not required | ❌ Broadcasts to LLMs only | User interfaces |
### Quick Agent Creation
```python
from hexaeight_mcp_client import quick_autogen_llm, quick_tool_agent, quick_user_agent
# LLM Agent (Intelligence Layer)
llm_agent = await quick_autogen_llm(
config_file="parent_config.json",
agent_type="parentLLM"
)
# Tool Agent (Business Logic Layer)
weather_agent = await quick_tool_agent(
config_file="weather_config.json",
service_formats=["weather_request", "forecast_request"],
agent_type="parentTOOL"
)
# User Agent (Interface Layer)
user_agent = await quick_user_agent(
config_file="user_config.json"
)
```
## 🔧 Implementing Business Logic (Tool Agents)
### Weather Service Example
```python
class WeatherService:
async def initialize(self):
# Create tool agent
self.agent = await quick_tool_agent(
config_file="weather_config.json",
service_formats=["weather_request", "location_query"],
agent_type="parentTOOL"
)
# Register your business logic
self.agent.register_service_handler("weather_request", self.handle_weather)
async def handle_weather(self, content, event, tracker):
"""YOUR ACTUAL BUSINESS LOGIC GOES HERE"""
# Parse request
request = json.loads(content)
location = request.get("location", "London")
# 🌍 CALL YOUR ACTUAL WEATHER API
weather_data = await self.call_openweather_api(location)
# Process and enhance data
enhanced_data = self.process_weather_data(weather_data)
# Send structured response
response = {
"type": "weather_response",
"location": location,
"data": enhanced_data,
"processed_by": self.agent.agent_name
}
await self.agent.hexaeight_agent.publish_to_agent(
self.agent.pubsub_url,
"internal_id",
event.sender_internal_id,
json.dumps(response),
"weather_response"
)
return True
```
## 🌐 Portable Child Agent Deployment
Deploy child agents anywhere without license requirements:
```bash
# Setup child agent environment on any machine
hexaeight-start setup-portable-child-agent-environment child_config.json
```
**Deployment Benefits:**
- 🌍 Deploy on cloud services (AWS, Azure, GCP)
- 🔧 Edge computing (Raspberry Pi, IoT devices)
- 📦 Container deployment (Docker, Kubernetes)
- ♾️ Child agents work forever (even after parent license expires)
## 📊 Complete Development Workflow
```bash
# 1. Learn concepts first
hexaeight-start show-concepts
# 2. Check system requirements
hexaeight-start check-prerequisites
# 3. Clean license activation
hexaeight-start license-activation
# 4. Create organized workspace
hexaeight-start create-directory-linked-to-hexaeight-license my-project
cd my-project
# 5. Generate agent configurations
hexaeight-start generate-parent-or-child-agent-licenses
# 6. Deploy sample multi-agent system
hexaeight-start deploy-multi-ai-agent-samples
# 7. Run the sample agents
python autogen_weather_agent.py # Terminal 1
python crewai_weather_agent.py # Terminal 2
python langchain_weather_agent.py # Terminal 3
# 8. Setup portable child agents on other machines
hexaeight-start setup-portable-child-agent-environment child_config.json
```
## 🎯 Use Cases
### Enterprise AI Assistants
- **LLM Agents**: Understand user requests, coordinate responses
- **Tool Agents**: CRM data, financial systems, inventory management
- **User Agents**: Employee interfaces, customer portals
### Data Analysis Platforms
- **LLM Agents**: Interpret analysis requests, generate insights
- **Tool Agents**: Database queries, API data feeds, visualization
- **User Agents**: Analyst interfaces, report generation
### Customer Service Automation
- **LLM Agents**: Natural language understanding, response generation
- **Tool Agents**: Ticketing systems, knowledge bases, payment processing
- **User Agents**: Customer chat interfaces, agent dashboards
### IoT and Smart Systems
- **LLM Agents**: Command interpretation, system orchestration
- **Tool Agents**: Device control, sensor data, automation rules
- **User Agents**: Mobile apps, voice interfaces, dashboards
## 🔒 Security Features
- **🛡️ Secure Agent Identity**: Cryptographic agent authentication and authorization
- **📡 Encrypted Communication**: All agent messages encrypted via HexaEight PubSub
- **🎯 Message Filtering**: Agents only process relevant messages based on type and format
- **🔍 Capability Isolation**: Tool agents expose only intended service capabilities
- **⚡ Automatic Locking**: Single-attempt message locking prevents processing conflicts
## 🛠️ Development Tools
```python
from hexaeight_mcp_client import *
# Check package info and framework availability
print_package_info()
# Setup development environment with example configs
setup_development_environment()
# Discover available configuration files
config_files = discover_config_files()
print("Available configs:", config_files)
# Validate agent types and configurations
is_valid = validate_agent_type("parentLLM")
agent_info = get_agent_type_info("parentLLM")
```
## 🆘 Troubleshooting
### Common Issues
**Q: "Failed to encrypt LLM configuration"**
A: Ensure you have a valid HexaEight agent loaded before creating the config protector.
**Q: "Tool agent not receiving messages"**
A: Verify your service_formats match the message types being sent by LLM agents.
**Q: "LLM verification failed"**
A: Make sure your agent_type is "parentLLM" or "childLLM" and provide appropriate verification responses.
**Q: "Connection to PubSub failed"**
A: Check that your Client Application is properly configured and PubSub server is running.
## 🚀 Getting Started Checklist
- [ ] Deploy HexaEight Agentic IAM Server from [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam)
- [ ] Create Client Application (get ClientID, Token Server URL, PubSub URL)
- [ ] Purchase HexaEight License from [store.hexaeight.com](https://store.hexaeight.com)
- [ ] Download "HexaEight Authenticator" mobile app
- [ ] Install hexaeight-mcp-client: `pip install hexaeight-mcp-client[all]`
- [ ] Run: `hexaeight-start show-concepts` (learn the concepts)
- [ ] Run: `hexaeight-start check-prerequisites`
- [ ] Run: `hexaeight-start license-activation`
- [ ] Create your first multi-agent system
- [ ] Build your first tool agent with actual business logic
- [ ] Test multi-agent coordination
- [ ] Deploy to production with real PubSub server
## 🔗 Links & Resources
- **🌐 Azure Marketplace**: [HexaEight Agentic IAM](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam) - Deploy IAM Server
- **🏪 HexaEight Store**: [store.hexaeight.com](https://store.hexaeight.com) - Purchase licenses
- **📖 Documentation**: [GitHub Repository](https://github.com/HexaEightTeam/hexaeight-mcp-client)
- **🐛 Issues**: [GitHub Issues](https://github.com/HexaEightTeam/hexaeight-mcp-client/issues)
- **📦 HexaEight Agent**: [hexaeight-agent on PyPI](https://pypi.org/project/hexaeight-agent/)
- **📱 Mobile App**: Search "HexaEight Authenticator" in app stores
## 📄 License
MIT License - see LICENSE file for details.
---
**🌟 Ready to build intelligent multi-agent systems with enterprise-grade security?**
Start with `pip install hexaeight-mcp-client[all]` and learn the concepts with `hexaeight-start show-concepts`!
Raw data
{
"_id": null,
"home_page": null,
"name": "hexaeight-mcp-client",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "mcp, agent, hexaeight, multi-agent, identity, security, autogen, crewai, langchain",
"author": null,
"author_email": "HexaEight <support@hexaeight.com>",
"download_url": "https://files.pythonhosted.org/packages/d4/dd/55c072523a7d9dc5337b047e232a5cb41d427f393f6fab8c2b6677d7587e/hexaeight_mcp_client-1.6.809.tar.gz",
"platform": null,
"description": "# HexaEight MCP Client\n\n\ud83d\ude80 **Framework-agnostic MCP integration with automatic multi-agent coordination and military-grade encryption.**\n\nBuild sophisticated multi-agent systems with minimal code while maintaining complete security and framework choice.\n\n## \ud83c\udf1f Key Features\n\n- \ud83d\udd10 **Secure Agent Identity** - Military-grade encryption for agent authentication and communication\n- \ud83e\udd16 **Framework Integration** - AutoGen, CrewAI, LangChain with secure agent coordination \n- \ud83d\udee0\ufe0f **Multi-Agent Types** - LLM agents, Tool agents, User agents with automatic coordination\n- \ud83c\udf10 **Automatic Discovery** - Dynamic capability discovery and intelligent message routing\n- \ud83d\udce1 **PubSub Coordination** - Seamless agent communication and task delegation\n- \u26a1 **One-Line Setup** - From configuration to production-ready agents instantly\n- \ud83c\udfaf **Business Logic** - Write your actual API/database code once in tool agents\n- \ud83d\udd12 **Production Security** - Zero plain-text secrets, secure agent identity management\n\n## \ud83d\udccb Prerequisites\n\n### 1. HexaEight Agentic IAM Server\nDeploy from Azure Marketplace to create Client Applications:\n- **Azure Marketplace**: [HexaEight Agentic IAM](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam)\n- Creates ClientID, Token Server URL, PubSub URL\n- Enables secure agent identity management\n\n### 2. Machine License\nPurchase and activate on your development machine:\n- **License Store**: [store.hexaeight.com](https://store.hexaeight.com)\n- Pricing: 1 CPU = $15, 2 CPU = $30, 4 CPU = $60 (minimum 5 days)\n- Enables creation of **1 parent configuration** + **unlimited child configurations**\n\n### 3. Mobile App Setup\n- Download **\"HexaEight Authenticator\"** app (iOS/Android)\n- Create generic resource (instant) or domain-based resource (branded)\n- Used for secure license activation\n\n### Agent Licensing Model\n\n| Agent Type | License Requirement | Expiry Behavior |\n|------------|--------------------|-----------------| \n| **Parent Agents** | \u2705 Active HexaEight license required | \u274c Stop working when license expires |\n| **Child Agents** | \u2705 Created with valid license | \u2705 Continue working after license expires |\n\n## \ud83d\ude80 Installation\n\n```bash\n# Basic installation\npip install hexaeight-mcp-client\n\n# With framework support\npip install hexaeight-mcp-client[autogen] # For AutoGen\npip install hexaeight-mcp-client[crewai] # For CrewAI\npip install hexaeight-mcp-client[langchain] # For LangChain\npip install hexaeight-mcp-client[all] # All frameworks\n```\n\n### Prerequisites Installation\n\n```bash\n# Core HexaEight agent package\npip install hexaeight-agent\n\n# Optional: Framework packages\npip install pyautogen # For AutoGen integration\npip install crewai # For CrewAI integration \npip install langchain # For LangChain integration\n```\n\n## \ud83c\udf93 Quick Start Guide\n\n### Step 1: Learn the Concepts\n```bash\n# Interactive presentation of HexaEight AI agent concepts\nhexaeight-start show-concepts\n\n# Auto-advancing presentation (no interaction required)\nhexaeight-start show-concepts --auto\n```\n\n### Step 2: Check Prerequisites\n```bash\n# Verify system requirements (.NET, dotnet-script)\nhexaeight-start check-prerequisites\n```\n\n### Step 3: Activate License\n```bash\n# Clean, focused license activation process\nhexaeight-start license-activation\n```\n\n### Step 4: Create Development Environment\n```bash\n# Create organized workspace with license hardlinks\nhexaeight-start create-directory-linked-to-hexaeight-license my-ai-project\ncd my-ai-project\n\n# Generate parent and child agent configuration files\nhexaeight-start generate-parent-or-child-agent-licenses\n\n# Deploy sample multi-agent weather system\nhexaeight-start deploy-multi-ai-agent-samples\n```\n\n## \ud83d\udd10 Secure LLM Configuration\n\n### Supported LLM Providers\n\n| Provider | Configuration Example |\n|----------|----------------------|\n| **OpenAI** | `{\"provider\": \"openai\", \"api_key\": \"sk-...\", \"model\": \"gpt-4\"}` |\n| **Azure OpenAI** | `{\"provider\": \"azure_openai\", \"api_key\": \"...\", \"azure_endpoint\": \"https://...\"}` |\n| **Anthropic** | `{\"provider\": \"anthropic\", \"api_key\": \"sk-ant-...\", \"model\": \"claude-3-sonnet\"}` |\n| **Local Ollama** | `{\"provider\": \"ollama\", \"base_url\": \"http://localhost:11434\", \"model\": \"llama2\"}` |\n\n## \ud83e\udd16 Framework Integration\n\n### AutoGen Integration\n\n```python\nfrom hexaeight_mcp_client import create_autogen_agent_with_hexaeight\n\n# Create AutoGen agent with secure HexaEight integration\nautogen_agent, hexaeight_agent = await create_autogen_agent_with_hexaeight(\n config_file=\"parent_config.json\",\n agent_type=\"parentLLM\",\n name=\"IntelligentCoordinator\",\n system_message=\"You can coordinate with multiple specialized agents and services.\"\n)\n\n# AutoGen agent now has:\n# \u2705 Secure HexaEight integration\n# \u2705 HexaEight coordination tools\n# \u2705 Automatic capability discovery\n# \u2705 Multi-agent coordination via PubSub\n```\n\n### CrewAI Integration\n\n```python\nfrom hexaeight_mcp_client import create_crewai_agent_with_hexaeight\n\n# Create CrewAI agent with secure HexaEight integration\ncrewai_agent, hexaeight_agent = await create_crewai_agent_with_hexaeight(\n config_file=\"parent_config.json\",\n agent_type=\"parentLLM\", \n role=\"Multi-Agent Coordinator\",\n goal=\"Coordinate complex workflows using available tools and services\",\n backstory=\"Expert in orchestrating multi-agent systems with secure communication\"\n)\n```\n\n### LangChain Integration\n\n```python\nfrom hexaeight_mcp_client import HexaEightAutoConfig\nfrom langchain.chat_models import ChatOpenAI\nfrom langchain.agents import initialize_agent\n\n# Create LangChain setup with HexaEight integration\nhexaeight_agent = await HexaEightAutoConfig.create_llm_agent(\n agent_type=\"parentLLM\",\n config_file=\"parent_config.json\",\n framework=\"langchain\"\n)\n\n# Use with LangChain for secure multi-agent coordination\ntools = hexaeight_agent.get_available_tools()\n# Integrate with your LangChain LLM of choice\n```\n\n## \ud83d\udee0\ufe0f Multi-Agent Architecture\n\n### Agent Types\n\n| Agent Type | Purpose | Verification | Broadcasts | Use Case |\n|------------|---------|--------------|------------|----------|\n| **parentLLM** | LLM coordination | \u2705 Required | \u2705 Receives all | Main intelligence and coordination |\n| **childLLM** | LLM task execution | \u2705 Required | \u2705 Receives all | Specialized LLM workers |\n| **parentTOOL** | Service provision | \u274c Not required | \u274c Ignores broadcasts | API services, databases |\n| **childTOOL** | Specialized services | \u274c Not required | \u274c Ignores broadcasts | Specific tool implementations |\n| **USER** | Human interaction | \u274c Not required | \u274c Broadcasts to LLMs only | User interfaces |\n\n### Quick Agent Creation\n\n```python\nfrom hexaeight_mcp_client import quick_autogen_llm, quick_tool_agent, quick_user_agent\n\n# LLM Agent (Intelligence Layer)\nllm_agent = await quick_autogen_llm(\n config_file=\"parent_config.json\",\n agent_type=\"parentLLM\"\n)\n\n# Tool Agent (Business Logic Layer) \nweather_agent = await quick_tool_agent(\n config_file=\"weather_config.json\",\n service_formats=[\"weather_request\", \"forecast_request\"],\n agent_type=\"parentTOOL\"\n)\n\n# User Agent (Interface Layer)\nuser_agent = await quick_user_agent(\n config_file=\"user_config.json\"\n)\n```\n\n## \ud83d\udd27 Implementing Business Logic (Tool Agents)\n\n### Weather Service Example\n\n```python\nclass WeatherService:\n async def initialize(self):\n # Create tool agent\n self.agent = await quick_tool_agent(\n config_file=\"weather_config.json\",\n service_formats=[\"weather_request\", \"location_query\"],\n agent_type=\"parentTOOL\"\n )\n \n # Register your business logic\n self.agent.register_service_handler(\"weather_request\", self.handle_weather)\n \n async def handle_weather(self, content, event, tracker):\n \"\"\"YOUR ACTUAL BUSINESS LOGIC GOES HERE\"\"\"\n \n # Parse request\n request = json.loads(content)\n location = request.get(\"location\", \"London\")\n \n # \ud83c\udf0d CALL YOUR ACTUAL WEATHER API\n weather_data = await self.call_openweather_api(location)\n \n # Process and enhance data\n enhanced_data = self.process_weather_data(weather_data)\n \n # Send structured response\n response = {\n \"type\": \"weather_response\",\n \"location\": location,\n \"data\": enhanced_data,\n \"processed_by\": self.agent.agent_name\n }\n \n await self.agent.hexaeight_agent.publish_to_agent(\n self.agent.pubsub_url,\n \"internal_id\",\n event.sender_internal_id,\n json.dumps(response),\n \"weather_response\"\n )\n \n return True\n```\n\n## \ud83c\udf10 Portable Child Agent Deployment\n\nDeploy child agents anywhere without license requirements:\n\n```bash\n# Setup child agent environment on any machine\nhexaeight-start setup-portable-child-agent-environment child_config.json\n```\n\n**Deployment Benefits:**\n- \ud83c\udf0d Deploy on cloud services (AWS, Azure, GCP)\n- \ud83d\udd27 Edge computing (Raspberry Pi, IoT devices)\n- \ud83d\udce6 Container deployment (Docker, Kubernetes)\n- \u267e\ufe0f Child agents work forever (even after parent license expires)\n\n## \ud83d\udcca Complete Development Workflow\n\n```bash\n# 1. Learn concepts first\nhexaeight-start show-concepts\n\n# 2. Check system requirements\nhexaeight-start check-prerequisites\n\n# 3. Clean license activation\nhexaeight-start license-activation\n\n# 4. Create organized workspace\nhexaeight-start create-directory-linked-to-hexaeight-license my-project\ncd my-project\n\n# 5. Generate agent configurations\nhexaeight-start generate-parent-or-child-agent-licenses\n\n# 6. Deploy sample multi-agent system\nhexaeight-start deploy-multi-ai-agent-samples\n\n# 7. Run the sample agents\npython autogen_weather_agent.py # Terminal 1\npython crewai_weather_agent.py # Terminal 2\npython langchain_weather_agent.py # Terminal 3\n\n# 8. Setup portable child agents on other machines\nhexaeight-start setup-portable-child-agent-environment child_config.json\n```\n\n## \ud83c\udfaf Use Cases\n\n### Enterprise AI Assistants\n- **LLM Agents**: Understand user requests, coordinate responses\n- **Tool Agents**: CRM data, financial systems, inventory management\n- **User Agents**: Employee interfaces, customer portals\n\n### Data Analysis Platforms \n- **LLM Agents**: Interpret analysis requests, generate insights\n- **Tool Agents**: Database queries, API data feeds, visualization\n- **User Agents**: Analyst interfaces, report generation\n\n### Customer Service Automation\n- **LLM Agents**: Natural language understanding, response generation \n- **Tool Agents**: Ticketing systems, knowledge bases, payment processing\n- **User Agents**: Customer chat interfaces, agent dashboards\n\n### IoT and Smart Systems\n- **LLM Agents**: Command interpretation, system orchestration\n- **Tool Agents**: Device control, sensor data, automation rules\n- **User Agents**: Mobile apps, voice interfaces, dashboards\n\n## \ud83d\udd12 Security Features\n\n- **\ud83d\udee1\ufe0f Secure Agent Identity**: Cryptographic agent authentication and authorization \n- **\ud83d\udce1 Encrypted Communication**: All agent messages encrypted via HexaEight PubSub\n- **\ud83c\udfaf Message Filtering**: Agents only process relevant messages based on type and format\n- **\ud83d\udd0d Capability Isolation**: Tool agents expose only intended service capabilities\n- **\u26a1 Automatic Locking**: Single-attempt message locking prevents processing conflicts\n\n## \ud83d\udee0\ufe0f Development Tools\n\n```python\nfrom hexaeight_mcp_client import *\n\n# Check package info and framework availability\nprint_package_info()\n\n# Setup development environment with example configs\nsetup_development_environment()\n\n# Discover available configuration files\nconfig_files = discover_config_files()\nprint(\"Available configs:\", config_files)\n\n# Validate agent types and configurations \nis_valid = validate_agent_type(\"parentLLM\")\nagent_info = get_agent_type_info(\"parentLLM\")\n```\n\n## \ud83c\udd98 Troubleshooting\n\n### Common Issues\n\n**Q: \"Failed to encrypt LLM configuration\"** \nA: Ensure you have a valid HexaEight agent loaded before creating the config protector.\n\n**Q: \"Tool agent not receiving messages\"** \nA: Verify your service_formats match the message types being sent by LLM agents.\n\n**Q: \"LLM verification failed\"** \nA: Make sure your agent_type is \"parentLLM\" or \"childLLM\" and provide appropriate verification responses.\n\n**Q: \"Connection to PubSub failed\"** \nA: Check that your Client Application is properly configured and PubSub server is running.\n\n## \ud83d\ude80 Getting Started Checklist\n\n- [ ] Deploy HexaEight Agentic IAM Server from [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam)\n- [ ] Create Client Application (get ClientID, Token Server URL, PubSub URL)\n- [ ] Purchase HexaEight License from [store.hexaeight.com](https://store.hexaeight.com)\n- [ ] Download \"HexaEight Authenticator\" mobile app\n- [ ] Install hexaeight-mcp-client: `pip install hexaeight-mcp-client[all]`\n- [ ] Run: `hexaeight-start show-concepts` (learn the concepts)\n- [ ] Run: `hexaeight-start check-prerequisites`\n- [ ] Run: `hexaeight-start license-activation`\n- [ ] Create your first multi-agent system\n- [ ] Build your first tool agent with actual business logic\n- [ ] Test multi-agent coordination\n- [ ] Deploy to production with real PubSub server\n\n## \ud83d\udd17 Links & Resources\n\n- **\ud83c\udf10 Azure Marketplace**: [HexaEight Agentic IAM](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/hexaeightopcprivatelimited1653195738074.hexaeight-agentic-iam) - Deploy IAM Server\n- **\ud83c\udfea HexaEight Store**: [store.hexaeight.com](https://store.hexaeight.com) - Purchase licenses\n- **\ud83d\udcd6 Documentation**: [GitHub Repository](https://github.com/HexaEightTeam/hexaeight-mcp-client)\n- **\ud83d\udc1b Issues**: [GitHub Issues](https://github.com/HexaEightTeam/hexaeight-mcp-client/issues)\n- **\ud83d\udce6 HexaEight Agent**: [hexaeight-agent on PyPI](https://pypi.org/project/hexaeight-agent/)\n- **\ud83d\udcf1 Mobile App**: Search \"HexaEight Authenticator\" in app stores\n\n## \ud83d\udcc4 License\n\nMIT License - see LICENSE file for details.\n\n---\n\n**\ud83c\udf1f Ready to build intelligent multi-agent systems with enterprise-grade security?**\n\nStart with `pip install hexaeight-mcp-client[all]` and learn the concepts with `hexaeight-start show-concepts`!\n",
"bugtrack_url": null,
"license": null,
"summary": "Framework-agnostic MCP client integration for HexaEight agents",
"version": "1.6.809",
"project_urls": {
"Documentation": "https://github.com/HexaEightTeam/hexaeight-mcp-client/blob/main/README.md",
"Homepage": "https://github.com/HexaEightTeam/hexaeight-mcp-client",
"Issues": "https://github.com/HexaEightTeam/hexaeight-mcp-client/issues",
"Repository": "https://github.com/HexaEightTeam/hexaeight-mcp-client.git"
},
"split_keywords": [
"mcp",
" agent",
" hexaeight",
" multi-agent",
" identity",
" security",
" autogen",
" crewai",
" langchain"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "419c20b532b0c1460b94152bd82672974de87dda59260155c44a7c62dc706dad",
"md5": "5e733d850c8ec3cc8f9fa01e3312a050",
"sha256": "b7c17ca302d3a1929a7adaf24599a238c48add3ded8170fce8d4bc5d2be249c7"
},
"downloads": -1,
"filename": "hexaeight_mcp_client-1.6.809-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5e733d850c8ec3cc8f9fa01e3312a050",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 101247,
"upload_time": "2025-07-25T08:42:47",
"upload_time_iso_8601": "2025-07-25T08:42:47.265667Z",
"url": "https://files.pythonhosted.org/packages/41/9c/20b532b0c1460b94152bd82672974de87dda59260155c44a7c62dc706dad/hexaeight_mcp_client-1.6.809-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d4dd55c072523a7d9dc5337b047e232a5cb41d427f393f6fab8c2b6677d7587e",
"md5": "470956c99ea9583760f9aa041c2b1d89",
"sha256": "4ef47549fc0a6e12d52eb450847a07b6cc26cb548a32370c8c2e82f61d4afab1"
},
"downloads": -1,
"filename": "hexaeight_mcp_client-1.6.809.tar.gz",
"has_sig": false,
"md5_digest": "470956c99ea9583760f9aa041c2b1d89",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 93094,
"upload_time": "2025-07-25T08:42:48",
"upload_time_iso_8601": "2025-07-25T08:42:48.561029Z",
"url": "https://files.pythonhosted.org/packages/d4/dd/55c072523a7d9dc5337b047e232a5cb41d427f393f6fab8c2b6677d7587e/hexaeight_mcp_client-1.6.809.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 08:42:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "HexaEightTeam",
"github_project": "hexaeight-mcp-client",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "hexaeight-mcp-client"
}
JSON
