Step 1: Prerequisites

Before getting started, ensure you have:

  • Python 3.10 or higher
  • An Observee account at observee.ai and MCP server selection
  • API keys for your preferred LLM provider

Step 2: Install the SDK

# Basic installation
pip install mcp-agents

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

Step 3: Get Your API Keys

Observee API Key

  1. Visit observee.ai
  2. Sign up or log in to your account
  3. Add your MCP servers
  4. Navigate to the API Keys section
  5. Create a new API key (starts with obs_)

LLM Provider Keys

Choose your preferred provider and get an API key:

Step 4: Environment Setup

Create a .env file in your project root:

# 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

Step 5: Your First Tool-Powered Conversation

from observee_agents import chat_with_tools

# Simple conversation with tool access
result = chat_with_tools(
    message="Search for recent news about AI developments",
    provider="anthropic",
    model="claude-sonnet-4-20250514",
    observee_api_key="obs_your_key_here"
)

print("🤖 AI Response:", result["content"])
print("🔧 Tools Used:", len(result["tool_calls"]))

Step 6: Explore Available Tools (Optional)

from observee_agents import list_tools, filter_tools

# See all available tools
tools = list_tools(observee_api_key="obs_your_key_here")
print(f"📦 Available tools: {len(tools)}")

# Find tools for specific tasks
email_tools = filter_tools(
    query="email management",
    max_tools=5,
    observee_api_key="obs_your_key_here"
)

for tool in email_tools:
    print(f"✉️  {tool['name']}: {tool['description']}")

What Just Happened?

🎉 Congratulations! You just:

  1. Connected to 1000+ tools - Gmail, YouTube, Linear, Slack, and more
  2. Used multiple LLM providers - Anthropic, OpenAI, and Google
  3. Filtered tools intelligently - Found relevant tools for your tasks

OAuth Authentication

For tools that require OAuth (Gmail, Slack, etc.), use the built-in authentication flows:

from observee_agents import call_mcpauth_login, get_available_servers

# See available services
servers = get_available_servers()
print(f"Available: {servers['supported_servers']}")

# Start authentication for Gmail
response = call_mcpauth_login(auth_server="gmail")
print(f"Visit: {response['url']}")

# Start authentication for Slack
response = call_mcpauth_login(auth_server="slack")
print(f"Visit: {response['url']}")

Supported Services: Gmail, Google Calendar, Google Docs, Google Drive, Google Sheets, Slack, Notion, Linear, Asana, Outlook, OneDrive, Atlassian, Supabase, Airtable, Discord, and more.

Common Use Cases

📧 Email Management

result = chat_with_tools(
    message="Check my Gmail inbox and summarize important emails",
    provider="anthropic"
)

🎥 Content Analysis

result = chat_with_tools(
    message="Get the transcript from this YouTube video: https://youtube.com/watch?v=example",
    provider="openai"
)

📋 Project Management

result = chat_with_tools(
    message="Create a new Linear issue for the bug I described",
    provider="gemini"
)
result = chat_with_tools(
    message="Search for the latest Python 3.12 features",
    provider="anthropic"
)

Next Steps

Now that you’re up and running, explore more advanced features:

Need Help?

What’s Next?

Ready to build something amazing? Check out our examples section for inspiration:

  • AI Email Assistant - Automated email management
  • Content Creation Pipeline - YouTube + Linear integration
  • Research Assistant - Web search + document generation
  • Project Manager Bot - Multi-platform project coordination

Happy building! 🚀