search_docs
Search documentation for ranked snippets that answer your query, then follow up with reading full pages.
Instructions
Search the documentation. Returns ranked snippets, not full pages.
Use this first for any question about a documented tool. Follow up with read_doc on the paths it returns.
If a NOTE says one of your words missed, believe it. Matching is OR, so a distinctive word can be outvoted by the common ones next to it — the note names the pages that word really lives on. Read one before you conclude the feature does not exist.
Pass source whenever the question names one product. These doc sets
cover the same ground in different words, so an unfiltered search spends
slots on the wrong products: a question about Claude Code hooks will also
return Cursor's and Codex's. Omit source only to compare products, or when
you genuinely do not know which one holds the answer.
A search costs ~500 tokens. Budget for two. The first query is the one you
can phrase; the second is the one the docs would. If the rows do not cohere
around your question — they name adjacent features, or only things you already
knew — do not answer from them. Guess what the docs call the thing and search
again. limit which model an org member can select returns org roles and spend
limits and warns about nothing; model access control — the docs' own name for
it — returns the right page first. You can usually produce that name; the cost
of trying is one more search.
Query in English. The indexed docs are English and matching is lexical, so a question in another language finds nothing — translate it to English keywords first ("훅 이벤트 목록" -> "hook events list").
Keyword-style queries work best and filler words are dropped. Symbols are
fine here — AGENTS.md, PreToolUse, --flag-name, spec_version all
match, because punctuation is treated as a word boundary rather than
dropped. Do not reach for grep_docs just because the query contains one.
There is no fuzzy matching, so a typo finds nothing.
Indexed sources: claude-code (Claude Code), codex (OpenAI Codex), cursor (Cursor), opencode (opencode), xai (xAI / Grok).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| source | No | One of: claude-code (Claude Code), codex (OpenAI Codex), cursor (Cursor), opencode (opencode), xai (xAI / Grok) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |