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

# Built-in Tools

> Learn how to use built-in tools in Agency Swarm.

In the latest version, Agency Swarm leverages tools from the [Agents SDK](https://openai.github.io/openai-agents-python/ref/tool/). This provides access to a comprehensive set of production-ready tools maintained by OpenAI.

## Available Tools

The agents SDK provides the following built-in tools:

### Hosted Tools

* **`WebSearchTool`** - Lets an agent search the web
* **`FileSearchTool`** - Allows retrieving information from your OpenAI Vector Stores
* **`ComputerTool`** - Allows automating computer use tasks
* **`CodeInterpreterTool`** - Lets the LLM execute code in a sandboxed environment
* **`ImageGenerationTool`** - Generates images from a prompt
* **`LocalShellTool`** - Runs shell commands on your machine

### Function Tools

* **`FunctionTool`** - Custom function-based tools using the `@function_tool` decorator

### MCP (Model Context Protocol) Tools

* **`HostedMCPTool`** - Exposes a remote MCP server's tools to the model

**When to use each tool:**

* **Web Search**: Real-time information retrieval, current events, up-to-date data
* **File Search**: Enriching agent knowledge, reducing hallucinations, querying documents
* **Computer Tool**: Automating computer use tasks, UI interactions, testing applications
* **Code Interpreter**: Data analysis, calculations, executing code in a sandboxed environment
* **Image Generation**: Creating visual content, illustrations, design assets from prompts
* **Local Shell**: System administration, file operations, running shell commands
* **Function Tool**: Creating custom tools with specific business logic using Python functions
* **Hosted MCP Tool**: Accessing tools from remote Model Context Protocol servers

### WebSearchTool Sources (all checked URLs)

```python theme={null}
from agency_swarm import Agent, WebSearchTool

agent = Agent(
    name="ResearchAgent",
    instructions="Search the web and summarize the best sources.",
    tools=[WebSearchTool()],
)
```

Use `include_web_search_sources=False` if you do not want source URLs in web-search tool calls.

For detailed documentation and additional configuration options, refer to the [agents SDK tool documentation](https://openai.github.io/openai-agents-python/ref/tool/).