Skip to main content

MCP tools

The server exposes two tools. Their descriptions can be overridden with the tools server option.

Searches the docs and returns matching pages, best first. See Search for how results are ranked.

{
"name": "docs_search",
"arguments": {
"query": "authentication",
"limit": 16
}
}
ParameterTypeDefaultDescription
querystringrequiredSearch query, up to 500 characters. Only the first 16 distinct terms are searched
limitnumber16Maximum results, 1–20

Each result has:

  • the page's full URL, to pass to docs_fetch
  • the title and relevance score
  • a snippet of matching content
  • the matching headings

docs_fetch​

Returns one page's full content as Markdown, or one section of it. Use it after searching.

{
"name": "docs_fetch",
"arguments": {
"url": "https://docs.example.com/docs/authentication"
}
}
ParameterTypeDescription
urlstringThe page: a URL from search results or a link in a fetched page. Add #heading-id for one section. Also a skill:// URI when the server serves skills

The result has:

  • the page title and description
  • a table of contents with anchor links
  • the full Markdown content

The server resolves the forms agents commonly pass to the page's URL: a trailing slash, a .md or .html suffix, /index.html, a query string, and root-relative paths like /docs/authentication (resolved against the site's origin). It never rewrites the host.

  • #heading-id: returns only that section, through its subsections, with a note naming the page. An unknown heading ID returns the whole page.
  • Not found: names the URL it tried, lists up to three pages whose path ends the same way (for moved pages), and points to docs_search.
  • skill:// URI: the skill file's text, exactly as resources/read serves it.

The exported docsFetchTool.inputSchema and docsFetchInputSchema still require an absolute URL, as in 2.0; only the schema the server registers accepts the other forms.

Other MCP features​

FeatureDetails
Protocol versions2026-07-28 (stateless, server/discover), and 2025-era revisions through initialize, on the same endpoint
Skills extensionio.modelcontextprotocol/skills: skills/list, skills/get. See Agent Skills
ResourcesEvery skill file at skill://<name>/<path>, readable with resources/read or docs_fetch
InstructionsThe instructions server option, followed by a pointer to the skills when any are served. See Instructions sent to clients
CachingOn protocol 2026-07-28, list and read results carry cache hints: ttlMs 5 minutes, cacheScope: public. 2025-era responses have none
ErrorsUnknown tools return JSON-RPC -32602