Tools

Tools are functions that agents call to interact with the world. ClaudePaw provides built-in tools across two tiers, and tenants can connect MCP servers for custom tooling.

Free-tier tools

Available on all plans. Run inside the Durable Object (no container needed).

• web_search — Brave Search API. Returns top results with snippets
• read_url — Fetches and extracts text content from a URL
• memory_read — Grep-searches HISTORY.md and NOTES.md
• memory_write — Appends timestamped entries to NOTES.md
• message — Sends to chat channels (Discord, Telegram, Slack via webhook)

Premium tools (Pro+)

Require a running Sandbox Container. Dispatched via internal service binding.

• exec — Runs shell commands. Returns stdout/stderr. Timeout cap: 120s
• read_file — Reads files from the agent workspace (R2-backed). Supports offset/limit
• write_file — Writes files to the agent workspace. Supports append mode
• browser — CDP-based browser automation: navigate, screenshot, click, type, extract, evaluate

Agency-tier tools

• subagent — Spawns a background agent instance for parallel work
• mcp_call — Calls any MCP server the tenant has connected

Tool access control

Each agent has an enabledTools field — a JSON array of tool names the agent is allowed to use. The gateway filters this list against the org's plan tier, so free-tier orgs can never access premium tools even if listed.

MCP servers

Tenants can connect external MCP (Model Context Protocol) servers to extend the tool registry. Configure the server URL and auth in the dashboard under Tools. The agent calls MCP tools the same way as built-in tools.