Search documentation and return relevant passages with source URLs.

Use this tool when you need to find information about specific topics, APIs, or concepts. The search uses BM25 ranking for relevance.

Args: query: The search query to find relevant documentation. limit: Maximum number of results to return (default: 5). source: Optional source name to filter results (e.g., 'fast_mcp', 'pydantic_ai').

Returns: List of search results with title, snippet, url, source (name), source_url, and score.

Get document content with pagination support for large documents.

For documents larger than 50KB, use offset/limit to paginate through content. The response includes has_more=True if more content is available. For targeted retrieval, use get_doc_excerpt instead.

Args: url: The URL of the document (as returned by search_docs). offset: Start position in bytes (default: 0). limit: Max bytes to return per call (default: 50000, max: 100000).

Returns: Document with content chunk, pagination metadata (offset, length, total_length, has_more).

Get relevant excerpts from a large document matching a query.

Use this instead of get_doc for large documents. Returns targeted excerpts based on BM25 relevance to your query.

Args: url: The URL of the document. query: Query to find relevant sections within the document. max_chunks: Maximum number of chunks to return (default: 5). context_chars: Extra context characters around each chunk (default: 500).

Returns: Document metadata with list of relevant excerpts, each containing content, position, and relevance score.

List all configured documentation sources with their statistics.

Use this to discover what documentation sources are available for searching. Each source has a name that can be used to filter search_docs results.

Returns: List of sources with name, url, doc_count, and last_updated.

Manually trigger a refresh of all documentation sources.

This fetches documentation from all configured llms.txt URLs and updates the local index. Use this when you need the latest documentation content.

Returns: Dictionary with refreshed_count, indexed_documents, indexed_chunks, sources, and any errors.