# Search Query Language
Hoarder provides a search query language to filter and find bookmarks. Here are all the supported qualifiers and how to use them:
## Basic Syntax
- Use spaces to separate multiple conditions (implicit AND)
- Use `and`/`or` keywords for explicit boolean logic
- Use parentheses `()` for grouping conditions
- Prefix qualifiers with `-` to negate them
## Qualifiers
Here's a comprehensive table of all supported qualifiers:
| Qualifier | Description | Example Usage |
| --------------- | -------------------------------------------------- | --------------------- |
| `is:fav` | Favorited bookmarks | `is:fav` |
| `is:archived` | Archived bookmarks | `-is:archived` |
| `is:tagged` | Bookmarks that has one or more tags | `is:tagged` |
| `is:inlist` | Bookmarks that are in one or more lists | `is:inlist` |
| `url:<value>` | Match bookmarks with URL substring | `url:example.com` |
| `#<tag>` | Match bookmarks with specific tag | `#important` |
| | Supports quoted strings for tags with spaces | `#"work in progress"` |
| `list:<name>` | Match bookmarks in specific list | `list:reading` |
| | Supports quoted strings for list names with spaces | `list:"to review"` |
| `after:<date>` | Bookmarks created on or after date (YYYY-MM-DD) | `after:2023-01-01` |
| `before:<date>` | Bookmarks created on orbefore date (YYYY-MM-DD) | `before:2023-12-31` |
### Examples
```plaintext
# Find favorited bookmarks from 2023 that are tagged "important"
is:fav after:2023-01-01 before:2023-12-31 #important
# Find archived bookmarks that are either in "reading" list or tagged "work"
is:archived and (list:reading or #work)
# Find bookmarks that are not tagged or not in any list
-is:tagged or -is:inlist
```
## Combining Conditions
You can combine multiple conditions using boolean logic:
```plaintext
# Find favorited bookmarks from 2023 that are tagged "important"
is:fav after:2023-01-01 before:2023-12-31 #important
# Find archived bookmarks that are either in "reading" list or tagged "work"
is:archived and (list:reading or #work)
# Find bookmarks that are not favorited and not archived
-is:fav -is:archived
```
## Text Search
Any text not part of a qualifier will be treated as a full-text search:
```plaintext
# Search for "machine learning" in bookmark content
machine learning
# Combine text search with qualifiers
machine learning is:fav
```
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/karakeep-app/karakeep'
If you have feedback or need assistance with the MCP directory API, please join our Discord server