Search across all AT Protocol documentation, lexicons, Bluesky API docs, and cookbook examples.

Use this tool to find information about AT Protocol concepts, endpoints, data structures, authentication, federation, and implementation patterns. Search is hybrid (keyword + semantic), so exact identifiers like NSIDs ("app.bsky.feed.getFeed") or endpoint names match reliably.

Args: query: Natural language search query (e.g. "how to create a post", "OAuth authentication flow", "what is a DID"). source: Optional filter — restrict to a specific source: "atproto-website" (protocol specs/guides from atproto.com), "bsky-docs" (Bluesky API docs from docs.bsky.app), "lexicons" (AT Protocol lexicon schemas), "cookbook" (example projects and code). Leave empty to search all sources. content_type: Optional filter — restrict to a content type: "guide" (tutorials and how-to guides), "spec" (protocol specifications), "blog" (blog posts), "reference" (lexicon schemas and API references), "example" (cookbook examples and code). Leave empty to search all types. limit: Maximum number of results (1-20, default 10).

Retrieve a specific AT Protocol lexicon by its NSID.

Returns the full lexicon schema including type definitions, properties, descriptions, and cross-references. Use this when you need the complete definition of a specific endpoint or record type.

Args: nsid: The Namespaced Identifier (e.g. "app.bsky.feed.post", "com.atproto.repo.createRecord", "chat.bsky.convo.sendMessage").

List all AT Protocol lexicons, optionally filtered by namespace prefix.

Use this to discover available lexicons and their NSIDs before fetching specific ones with get_lexicon.

Args: namespace: Optional namespace prefix to filter by (e.g. "app.bsky.feed", "com.atproto.repo", "chat.bsky", "tools.ozone"). Leave empty to list all.

Search within AT Protocol lexicons using semantic search.

Searches lexicon descriptions, property names, types, and definitions. More targeted than search_atproto_docs when you specifically need lexicon/schema information.

Args: query: Search query (e.g. "post creation", "follow relationship", "blob upload", "moderation labels"). limit: Maximum results (1-20, default 10).

Retrieve a specific AT Protocol cookbook example by project name.

Returns the project README, file listing, and key source code files. Use this when you need implementation examples or starter code.

Args: name: Project directory name (e.g. "python-bsky-post", "ts-bot", "go-repo-export", "python-oauth-web-app"). Use list_cookbook_examples to discover available projects.

List all AT Protocol cookbook examples (starter projects and scripts).

Use this to discover available example projects before fetching specific ones with get_cookbook_example.

Args: language: Optional filter by language ("python", "go", "typescript", "javascript"). Leave empty to list all.

Search Bluesky developer API documentation (docs.bsky.app).

Searches guides, tutorials, and advanced topics specific to the Bluesky API. Use this for questions about Bluesky-specific features like the firehose, federation, moderation, or API usage patterns.

Args: query: Search query (e.g. "firehose subscription", "custom feeds", "authentication", "rate limits"). limit: Maximum results (1-20, default 10).

Force re-fetch all AT Protocol source repositories and rebuild the search index.

Use this when you suspect the documentation is outdated or when upstream repos have been updated. This operation may take several minutes as it clones repositories and rebuilds the embeddings index.