AgentMCP: The Universal System for AI Agent Collaboration

> Unleashing a new era of AI collaboration: AgentMCP is the system that makes any AI agent work with every other agent - handling all the networking, communication, and coordination between them. Together with MACNet (The Internet of AI Agents), we're creating a world where AI agents can seamlessly collaborate across any framework, protocol, or location.

✨ The Magic: Transform Your Agent in 30 Seconds

Turn any existing AI agent into a globally connected collaborator with just one line of code.

pip install agent-mcp  # Step 1: Install

from agent_mcp import mcp_agent  # Step 2: Import
@mcp_agent(mcp_id="MyAgent")      # Step 3: Add this one decorator! 🎉

class MyExistingAgent:

    # ... your agent's existing code ...

    def analyze(self, data):

        return "Analysis complete!"

That's it! Your agent is now connected to the Multi-Agent Collaboration Network (MACNet), ready to work with any other agent, regardless of its framework.

➡️ Jump to Quick Demos to see it live! ⬅️

What is AgentMCP?

AgentMCP is the world's first universal system for AI agent collaboration. Just as operating systems and networking protocols enabled the Internet, AgentMCP handles all the complex work needed to make AI agents work together:
- Converting agents to speak a common language
- Managing network connections and discovery
- Coordinating tasks and communication
- Ensuring secure and reliable collaboration

With a single decorator, developers can connect their agents to MACNet (our Internet of AI Agents), and AgentMCP takes care of everything else - the networking, translation, coordination, and collaboration. No matter what framework or protocol your agent uses, AgentMCP makes it instantly compatible with our global network of AI agents.

📚 Examples

🚀 Quick Demos: See AgentMCP in Action!

These examples show the core power of AgentMCP. See how easy it is to connect agents and get them collaborating!

1. Simple Multi-Agent Chat (Group Chat)

Watch two agents built with different frameworks (Autogen and LangGraph) chat seamlessly.

The Magic: The @mcp_agent decorator instantly connects them.

From demos/basic/simple_chat.py:

# --- Autogen Agent --- 

@mcp_agent(mcp_id="AutoGen_Alice")

class AutogenAgent(autogen.ConversableAgent):

    # ... agent code ...

--- LangGraph Agent --- 
@mcp_agent(mcp_id="LangGraph_Bob")
class LangGraphAgent:
    # ... agent code ...

Run it:

python demos/network/test_deployed_network.py

3. Multi-Provider Cost Optimization (NEW!)

See how AgentMCP automatically reduces costs by 80-90% through intelligent provider selection.

The Magic:
- Automatic Provider Routing: Chooses most cost-effective AI provider for each task
- Quality Preservation: Maintains high quality while reducing costs
- Real-time Optimization: Continuously optimizes based on task requirements

From demos/cost/test_cost_optimization.py:

# Multi-provider setup with cost optimization

providers = [

    {"name": "OpenAI", "model": "gpt-4", "cost_per_token": 0.00003},

    {"name": "Gemini", "model": "gemini-pro", "cost_per_token": 0.00001},

    {"name": "Claude", "model": "claude-3-sonnet", "cost_per_token": 0.000015},

    {"name": "Agent Lightning", "model": "lightning-fast", "cost_per_token": 0.000005}

]

@optimize_costs(target_reduction=0.85)

class MultiProviderAgent:

    def process_task(self, task):

        # Automatically routes to best provider

        return "Task processed at optimal cost!"

What it shows:
- 80-90% Cost Reduction: Significant savings without quality loss
- Provider Flexibility: Any combination of AI providers supported
- Transparent Optimization: See cost breakdown and provider choices

Run it:

python demos/cost/test_cost_optimization.py

4. Agent Lightning Advanced Features (NEW!)

Experience the revolutionary capabilities of Agent Lightning with Auto-Prompt Optimization (APO) and Reinforcement Learning.

The Magic:
- APO Technology: Automatically optimizes prompts for better performance
- Reinforcement Learning: Agents improve over time through experience
- Heterogeneous Collaboration: Works seamlessly with other AI providers

From demos/lightning/test_lightning_features.py:

@lightning_agent(enable_apo=True, enable_rl=True)

class AdvancedLightningAgent:

    def analyze_data(self, data):

        # APO automatically optimizes the prompt

        # RL improves performance over time

        return self.optimized_analysis(data)

What it shows:
- Auto-Prompt Optimization: 40-60% better results through automatic prompt tuning
- Reinforcement Learning: Continuous improvement through experience
- Seamless Integration: Works with any other AI framework in AgentMCP

Run it:

python demos/lightning/test_lightning_features.py

Why AgentMCP Matters

In today's fragmented AI landscape, agents are isolated by their frameworks and platforms. AgentMCP changes this by providing:
- A Universal System: The operating system for AI agent collaboration.
- The Global Network (MACNet): Connect to the Internet of AI Agents.
- Simplicity: Achieve powerful collaboration with minimal effort.
- Framework Independence: Build agents your way; we handle the integration.
- Scalability: Enterprise-ready features for secure, large-scale deployment.

---

🔑 Core Concepts & Benefits

AgentMCP is built on a few powerful ideas:

🎯 One Decorator = Infinite Possibilities

> The @mcp_agent decorator is the heart of AgentMCP's simplicity and power. Adding it instantly transforms your agent:

- 🌐 Connects it to the Multi-Agent Collaboration Network (MACNet).
- 🤝 Makes it discoverable and ready to collaborate with any other agent on MACNet.
- 🔌 Ensures compatibility regardless of its underlying framework (Langchain, CrewAI, Autogen, Custom, etc.).
- 🧠 Empowers it to share context and leverage specialized capabilities from agents worldwide.

Result: No complex setup, no infrastructure headaches – just seamless integration into the global AI agent ecosystem.

💡 Analogy: Like Uber for AI Agents

Think of AgentMCP as the platform connecting specialized agents, much like Uber connects drivers and riders:

- Your Agent: Offers its unique skills (like a driver with a car).
- Need Help?: Easily tap into a global network of specialized agents (like hailing a ride).
- No Lock-in: Works with any agent framework or custom implementation.
- Effortless Connection: One decorator is all it takes to join or utilize the network.

🛠 Features That Just Work

AgentMCP handles the complexities behind the scenes:

For Your Agent:

- Auto-Registration & Authentication: Instant, secure network access.
- Tool Discovery & Smart Routing: Automatically find and communicate with the right agents for the task.
- Built-in Basic Memory: Facilitates context sharing between collaborating agents.
- Availability Management: Handles agent online/offline status and ensures tasks are routed to active agents.

For Developers:

…