Title100/100
Search notes
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Searches the user's notes by their words (titles first, then bodies) and by meaning, so a question in other words still finds the note. Returns each note's id, title, project, url and, for a body match, the passage that matched. Use get_note to read one whole.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
What to look for: words from a note, a topic, or a question the notes might answer. Searching by meaning needs at least 3 characters; shorter queries match words only.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
How many notes to return at most, best matches first.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search notes",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema87/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"project",
"url"
],
"properties": {
"id": {
"type": "string",
"description": "The note's id, for get_note and append_to_note."
},
"url": {
"type": "string",
"description": "Where the user opens it in Breef: give it to them when you mention it."
},
"title": {
"type": "string"
},
"project": {
"type": [
"string",
"null"
],
"description": "The name of the project it's in, or null if it's in none."
},
"snippet": {
"type": "string",
"description": "The passage that matched, or the start of a note found by meaning. Missing when only the title matched."
}
}
},
"description": "The notes found, best matches first; empty when nothing matched."
}
}
}