# tools Option

> The option that sets which built-in tools are there at all.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** Agent SDK available tools, tools preset, Claude Agent SDK tools

## Think of it like

It is like choosing which tools go in the toolbox at all.

## Definition

tools is the Agent SDK option that sets which built-in tools exist in a session. You pass a list of tool names, or the claude_code preset for Claude Code's full set. A tool left out is gone, so Claude never sees it. An empty list removes every built-in tool, which leaves only your MCP tools. It decides what exists, not what runs without asking.

## Example

Mia's agent should only use her own database tools. She passes tools: [], so no built-in tool is there to tempt it.

## Example code

```typescript
tools: ["Read", "Grep", "Glob"]
```

Only these three built-in tools exist.

## Why it matters

A tool Claude cannot see is one it cannot misuse. It also costs no space in the context.

## Common mistake

Using tools to skip the approval step. It only sets what is there. Approval is allowedTools.

## Three principles

- **Decides what exists.** Not approval.
- **Empty list.** MCP tools only.
- **Preset for the full set.** claude_code.

## Related terms

- [allowedTools Option](https://learn.benibix.com/term/ai/allowed-tools-option)
- [disallowedTools Option](https://learn.benibix.com/term/ai/disallowed-tools-option)
- [--tools Flag](https://learn.benibix.com/term/ai/tools-flag)

## Told apart from

- [tools vs allowedTools](https://learn.benibix.com/compare/tools-option-vs-allowed-tools-option): People think tools and allowedTools do the same job. tools decides which built-in tools exist, so a tool left out is never seen by Claude. allowedTools decides which of the tools that exist run without asking. Use tools to shrink the toolbox, and allowedTools to skip the prompt.

---

Source: https://learn.benibix.com/term/ai/tools-option
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
