Skip to content
BENIBIX Learn

tools Option

Also known as Agent SDK available tools, tools preset, Claude Agent SDK tools

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

Think of it like

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

Example

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

Why it matters

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

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 code

typescript
tools: ["Read", "Grep", "Glob"]
Only these three built-in tools exist.

Common mistake

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

Key takeaways

  1. 1
    Decides what exists. Not approval.
  2. 2
    Empty list. MCP tools only.
  3. 3
    Preset for the full set. claude_code.

Compare