ask_user_input_v0
Present tappable options to gather user preferences before providing advice. This tool displays interactive buttons that users can tap to answer, which is much easier than typing on mobile.
WHEN TO USE THIS TOOL: Use this for ELICITATION - when you need to understand the user's preferences, constraints, or goals to give useful advice.
Examples of when to USE this tool: - 'Help me plan a workout routine' -> Ask about goals (strength/cardio/weight loss), time available, equipment access - 'Help me find a book to read' -> Ask about genres, mood, recent favorites - 'I'm thinking about getting a pet' -> Ask about lifestyle, living situation, time commitment - 'Help me pick a gift for my friend' -> Ask about occasion, budget, friend's interests
CRITICAL: Before asking, check the conversation — if the answer is already there or inferable (their code's language, their query's syntax, an order they already gave), use it. If you do need to ask and you're about to write clarifying questions as prose bullets, STOP — those go in this tool instead.
WHEN NOT TO USE THIS TOOL: - User asks 'A or B?' (e.g., 'Should I learn Python or JavaScript?') -> They want YOUR analysis and recommendation, not the options repeated back as buttons - User is venting or processing emotions (e.g., 'I'm having a bad day') -> Just listen and respond supportively - User asks for your opinion (e.g., 'What do you think of eggs?') -> Give your perspective directly - Factual questions (e.g., 'What's the capital of France?') -> Just answer - User needs prose feedback (e.g., 'Review my code') -> Provide written analysis - User already gave you a detailed prompt with specific constraints -> They've done the narrowing themselves; asking for more second-guesses them. Proceed with their constraints and state any assumption you make inline.
Always include a brief conversational message before presenting options - don't show options silently. Keep it to one question where possible — three is a ceiling, not a target — with 2-4 short, mutually exclusive options.
After calling this, your turn is done — the user's selection comes as their next message, not a tool result. Don't keep writing.
bash_tool
Run a bash command in the container
create_file
Create a new file with content in the container. Fails if the path already exists — use str_replace to edit an existing file, or bash_tool (cat > path << 'EOF') to overwrite it.
end_conversation
Use this tool to end the conversation. This tool will close the conversation and prevent any further messages from being sent.
fetch_sports_data
Use this tool whenever you need to fetch current, upcoming or recent sports data including scores, standings/rankings, and detailed game stats for the provided sports. If a user is interested in the score of an event or game, and the game is live or recent in last 24hr, fetch both the game scores and game_stats in the same turn (game stats are not available for golf and nascar). For broad queries (e.g. 'latest NBA results'), fetch both scores and standings. Do NOT rely on your memory or assume which players are in a game; fetch both scores, stats, details using the tool. Important: Bias towards fetching score and stats BEFORE responding to the user with workflow: 1) fetch score 2) fetch stats based on game id 3) only then respond to the user. PREFER using this tool over web search for data, scores, stats about recent and upcoming games.
image_search
Default to using image search for any query where visuals would enhance the user's understanding; skip when the deliverable is primarily textual e.g. for pure text tasks, code, technical support.
message_compose_v1
Draft a message (email, Slack, or text) with goal-oriented approaches based on what the user is trying to accomplish. Analyze the situation type (work disagreement, negotiation, following up, delivering bad news, asking for something, setting boundaries, apologizing, declining, giving feedback, cold outreach, responding to feedback, clarifying misunderstanding, delegating, celebrating) and identify competing goals or relationship stakes. **MULTIPLE APPROACHES** (if high-stakes, ambiguous, or competing goals): Start with a scenario summary. Generate 2-3 strategies that lead to different outcomes—not just tones. Label each clearly (e.g., "Disagree and commit" vs "Push for alignment", "Gentle nudge" vs "Create urgency", "Rip the bandaid" vs "Soften the landing"). Note what each prioritizes and trades off. **SINGLE MESSAGE** (if transactional, one clear approach, or user just needs wording help): Just draft it. For emails, include a subject line. Adapt to channel—emails longer/formal, Slack concise, texts brief. Test: Would a user choose between these based on what they want to accomplish?
places_map_display_v0
Display locations on a map with your recommendations and insider tips.
WORKFLOW:
1. Use places_search tool first to find places and get their place_id
2. Call this tool with place_id references - the backend will fetch full details
CRITICAL: Copy place_id values EXACTLY from places_search tool results. Place IDs are case-sensitive and must be copied verbatim - do not type from memory or modify them.
TWO MODES - use ONE of:
A) SIMPLE MARKERS - just show places on a map:
{
"locations": [
{
"name": "Blue Bottle Coffee",
"latitude": 37.78,
"longitude": -122.41,
"place_id": "ChIJ..."
}
]
}
B) ITINERARY - show a multi-stop trip with timing:
{
"title": "Tokyo Day Trip",
"narrative": "A perfect day exploring...",
"days": [
{
"day_number": 1,
"title": "Temple Hopping",
"locations": [
{
"name": "Senso-ji Temple",
"latitude": 35.7148,
"longitude": 139.7967,
"place_id": "ChIJ...",
"notes": "Arrive early to avoid crowds",
"arrival_time": "8:00 AM",
}
]
}
],
"travel_mode": "walking",
"show_route": true
}
LOCATION FIELDS:
- name, latitude, longitude (required)
- place_id (recommended - copy EXACTLY from places_search tool, enables full details)
- notes (your tour guide tip)
- arrival_time, duration_minutes (for itineraries)
- address (for custom locations without place_id)
places_search
Search for places, businesses, restaurants, and attractions using Google Places.
SUPPORTS MULTIPLE QUERIES in a single call. Multiple queries can be used for:
- efficient itinerary planning
- breaking down broad or abstract requests: 'best hotels 1hr from London' does not translate well to a direct query. Rather it can be decomposed like: 'luxury hotels Oxfordshire', 'luxury hotels Cotswolds', 'luxury hotels North Downs' etc.
USAGE:
{
"queries": [
{ "query": "temples in Asakusa", "max_results": 3 },
{ "query": "ramen restaurants in Tokyo", "max_results": 3 },
{ "query": "coffee shops in Shibuya", "max_results": 2 }
]
}
Each query can specify max_results (1-10, default 5).
Results are deduplicated across queries.
For place names that are common, make sure you include the wider area e.g. restaurants Chelsea, London (to differentiate vs Chelsea in New York).
RETURNS: Array of places with place_id, name, address, coordinates, rating, photos, hours, and other details. IMPORTANT: Display results to the user via the places_map_display_v0 tool (preferred) or via text. Irrelevant results can be disregarded and ignored, the user will not see them.
present_files
The present_files tool makes files visible to the user for viewing and rendering in the client interface.
When to use the present_files tool:
- Making any file available for the user to view, download, or interact with
- Presenting multiple related files at once
- After creating a file that should be presented to the user
When NOT to use the present_files tool:
- When you only need to read file contents for your own processing
- For temporary or intermediate files not meant for user viewing
How it works:
- Accepts an array of file paths from the container filesystem
- Returns output paths where files can be accessed by the client
- Output paths are returned in the same order as input file paths
- Multiple files can be presented efficiently in a single call
- If a file is not in the output directory, it will be automatically copied into that directory
- The first input path passed in to the present_files tool, and therefore the first output path returned from it, should correspond to the file that is most relevant for the user to see first
recipe_display_v0
Display an interactive recipe with adjustable servings. Use when the user asks for a recipe, cooking instructions, or food preparation guide. The widget allows users to scale all ingredient amounts proportionally by adjusting the servings control.
recommend_claude_apps
Recommend 1-3 Claude apps or extensions whenever the user's current task maps to one. Be proactive: if a relevant app exists for what they're doing, show this tool—don't wait for them to ask about apps. This never replaces doing the task: complete the user's request in chat as normal and show the recommendation alongside your answer as a "next time, this kind of work is even better in …" suggestion. Never refuse, shorten, or hand off the current task just because an app exists. Prioritize these four whenever they fit: claude_code_desktop for anything code-related (writing, debugging, reviewing, or shipping code, scripts, or repos—use the terminal/VS Code/JetBrains variant instead only if they mention that environment); cowork for heavier multi-step work like research, analysis, long-form writing, or tasks involving many tool calls and files; claude_design for prototypes, mockups, and visual work like designs, landing pages, slides, or one-pagers; excel for any spreadsheet work, formulas, data cleanup, or models. Examples: working on a spreadsheet → excel; building a prototype or mockup → claude_design; writing or fixing code → claude_code_desktop; research, analysis, or writing that spans many steps or tools → cowork. Recommend the other apps when they're the clear fit instead: powerpoint for slide decks, word for drafting or editing documents, outlook for inbox triage and email replies, chrome for browsing or acting on websites, desktop for working alongside files and apps generally, ios/android for Claude on the go. For each app you recommend, also write a personalized one-line value prop in descriptions, tied to what the user is doing right now. Only include apps relevant to the current use case, sorted by relevance with the single best fit first. Recommend at most one of desktop/cowork/claude_code_desktop at a time (on the web they all install Claude Desktop). The UI shows each app with an icon, its value prop, and the right call to action for the user's platform (Install, Download, or Open—users already in the desktop app see Open instead of Download).
search_mcp_registry
Search for available connectors in the MCP registry. Call this when connecting to a new MCP might help resolve the user query — whether or not they name a specific product.
Named-product examples:
- "check my Asana tasks" → search ["asana", "tasks", "todo"]
- "find issues in Jira" → search ["jira", "issues"]
Intent-based examples (no product named):
- "help me manage my tasks" → search ["tasks", "todo", "project management"]
- "what's on my calendar tomorrow" → search ["calendar", "schedule", "events"]
- "did I get a reply from them yet" → search ["email", "messages", "inbox"]
- "pull up the design mockups" → search ["design", "mockup"]
- "check if the CI passed" → search ["ci", "build", "pipeline"]
- "did the call cover Mike's latest ticket" → thinking: "I don't have any context about the call or meeting, let's see if there are any connectors available" → search ["meeting", "call", "transcript"]
If the request implies reading the user's data (email, calendar, tasks, files, tickets, etc.) and you don't already have a tool for it, search — even if the phrasing is casual. "Did I get a reply" is an email check. "What's pending" is a task check.
Returns a ranked list. If results look relevant, call suggest_connectors to present the options. If nothing matches the task, do NOT call suggest_connectors — fall through to the browser or answer directly depending on the task type (booking/action tasks go to navigate; info requests get a direct answer).
str_replace
Replace a unique string in a file with another string. old_str must match the raw file content exactly and appear exactly once. When copying from view output, do NOT include the line number prefix (spaces + line number + tab) — it is display-only. View the file immediately before editing; after any successful str_replace, earlier view output of that file in your context is stale — re-view before further edits to the same file. Files under /mnt/user-data/uploads, /mnt/transcripts, /mnt/skills/public, /mnt/skills/private, /mnt/skills/examples are read-only — copy them to a writable location first if you need to edit them.
suggest_connectors
Present connector options to the user. Each option renders with a Connect or Use button, plus a "None of these" option. The user's choice arrives as a follow-up message.
Call this when any of the following are true:
- A relevant option is an MCP App (tools tagged [third_party_mcp_app]) and the user did not explicitly name that company — even if the connector is already connected
- The user has no connected tool that can fulfill the request
- The user explicitly asks what connectors are available (e.g. "what can help me manage my tasks")
- A tool call failed with an auth/credential error — pass the server UUID from the failed tool name mcp__{uuid}__{toolName} so the user can re-authenticate
Do NOT call this tool unless you have already called the search_mcp_registry tool or are handling a tool auth/credential error.
Do NOT call this if the user named a specific connected service — just use it.
If search_mcp_registry returned nothing relevant, do NOT call this — answer the user directly instead.
Pass directoryUuid values from search_mcp_registry results — not connector names, not guesses. If you haven't called search_mcp_registry yet, call it first to get the UUIDs. Include all relevant options in uuids (connected or not).
End your turn after calling this with a short framing line like "I found a few options — which would you like?" — don't continue with a generic answer. The user's selection arrives as a follow-up message like "Use {name} for this" (they picked one) or "Don't use a connector" (they picked None of these).
view
Supports viewing text, images, and directory listings.
Supported path types:
- Directories: Lists files and directories up to 2 levels deep, ignoring hidden items and node_modules
- Image files (.jpg, .jpeg, .png, .gif, .webp): Displays the image visually
- Text files: Displays numbered lines (prefix " N\t" is display-only — do not include it in str_replace's `old_str`). You can optionally specify a view_range to see specific lines.
Note: Files with non-UTF-8 encoding will display hex escapes (e.g. \x84) for invalid bytes
weather_fetch
Display weather information. Use the user's home location to determine temperature units: Fahrenheit for US users, Celsius for others.
USE THIS TOOL WHEN: - User asks about weather in a specific location - User asks 'should I bring an umbrella/jacket' - User is planning outdoor activities - User asks 'what's it like in [city]' (weather context)
SKIP THIS TOOL WHEN: - Climate or historical weather questions - Weather as small talk without location specified
web_fetch
Fetch the contents of a web page at a given URL.
Only URLs that already appear in this conversation can be fetched: ones the person provided, or ones returned by a prior web_search or web_fetch. A URL recalled from training or built by editing a seen URL's path will be rejected; call web_search or fetch a linking page instead.
This tool cannot access content that requires authentication, such as private Google Docs or pages behind login walls.
Do not add www. to URLs that do not have them.
URLs must include the schema: https://example.com is a valid URL while example.com is an invalid URL.
web_search
Search the web
visualize:read_me
Returns required context for show_widget (CSS variables, colors, typography, layout rules, examples). Call before your first show_widget call. Call again later if you need a different module. Do NOT mention or narrate this call to the user — it is an internal setup step. Call it silently and proceed directly to the visualization in your response.
visualize:show_widget
Show visual content — SVG graphics, diagrams, charts, or interactive HTML widgets — that renders inline alongside your text response.
Use for flowcharts, architecture diagrams, dashboards, forms, calculators, data tables, games, illustrations, or any visual content.
The code is auto-detected: starts with