> ## Documentation Index
> Fetch the complete documentation index at: https://docs.observee.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool Usage

> Direct tool execution and discovery in Python

## Direct Tool Execution

```python theme={null}
from observee_agents import execute_tool

# Get YouTube transcript directly
transcript = execute_tool(
    tool_name="youtube_get_transcript",
    tool_input={"video_url": "https://youtube.com/watch?v=example"}
)

# Search web directly
search_results = execute_tool(
    tool_name="brave_search",
    tool_input={"query": "Python 3.12 features"}
)

# Create Linear issue directly
issue = execute_tool(
    tool_name="linear_create_issue",
    tool_input={
        "title": "New Feature Request",
        "description": "Add dark mode support"
    }
)
```

## Tool Discovery

```python theme={null}
from observee_agents import filter_tools, list_tools

# List all available tools
all_tools = list_tools(observee_api_key="obs_your_key_here")
print(f"Found {len(all_tools)} tools")

for tool in all_tools[:5]:  # Show first 5
    print(f"- {tool['name']}: {tool['description']}")
```

## Filter Tools by Task

```python theme={null}
from observee_agents import filter_tools

# Find productivity tools
productivity_tools = filter_tools(
    query="productivity task management",
    max_tools=5
)

for tool in productivity_tools:
    print(f"📋 {tool['name']}: {tool['description']}")

# Find communication tools
comm_tools = filter_tools(
    query="communication messaging slack email",
    max_tools=3
)

for tool in comm_tools:
    print(f"💬 {tool['name']}: {tool['description']}")

# Find content creation tools
content_tools = filter_tools(
    query="youtube video content creation",
    max_tools=5
)

for tool in content_tools:
    print(f"🎥 {tool['name']}: {tool['description']}")
```

## Get Tool Information

```python theme={null}
from observee_agents import get_tool_info

# Get detailed info about a specific tool
tool_info = get_tool_info(
    tool_name="youtube_get_transcript",
    observee_api_key="obs_your_key_here"
)

if tool_info:
    print(f"Tool: {tool_info['name']}")
    print(f"Description: {tool_info['description']}")
    print(f"Parameters: {tool_info['parameters']}")
```