​
Installation

​
Prerequisites

  • Python 3.8 or higher
  • An Observee account at observee.ai
  • API keys for your preferred LLM provider

​
Install the SDK

# Basic installation
pip install mcp-agents

# With optional dependencies
pip install mcp-agents[embedding,cloud,dev]

​
Get Your API Keys

​
1. Observee API Key

  1. Visit observee.ai
  2. Sign up or log in
  3. Navigate to API Keys
  4. Create a new API key (starts with obs_)

​
2. LLM Provider Keys

Choose your preferred provider:

​
Environment Setup

Create a .env file:

# Required
OBSERVEE_API_KEY=obs_your_api_key_here

# Choose your LLM provider
ANTHROPIC_API_KEY=your_anthropic_key_here
OPENAI_API_KEY=your_openai_key_here
GOOGLE_API_KEY=your_gemini_key_here

​
Test Installation

from observee_agents import chat_with_tools

try:
    result = chat_with_tools(
        message="Hello! What tools do you have?",
        provider="anthropic",
        observee_api_key="obs_your_key_here"
    )
    print("✅ Installation successful!")
    print(f"Response: {result['content']}")
except Exception as e:
    print(f"❌ Installation issue: {e}")

​
Troubleshooting

ImportError: Run pip install --upgrade mcp-agents

Authentication Error: Check your API keys are correct

Tool Issues: Install embedding dependencies: pip install mcp-agents[embedding]

​
Next Steps