search_messages
Search a project's messages by subject and body using full-text queries with phrase, prefix, and boolean support to find relevant conversations and context.
Instructions
Full-text search over subject and body for a project.
Tips
SQLite FTS5 syntax supported: phrases ("build plan"), prefix (mig*), boolean (plan AND users)
Results are ordered by bm25 score (best matches first)
Limit defaults to 20; raise for broad queries
Query examples
Phrase search:
"build plan"Prefix:
migrat*Boolean:
plan AND usersRequire urgent:
urgent AND deployment
Parameters
project_key : str Project identifier. query : str FTS5 query string. limit : int Max results to return.
Returns
list[dict] Each entry: { id, subject, importance, ack_required, created_ts, thread_id, from }
Example
{"jsonrpc":"2.0","id":"10","method":"tools/call","params":{"name":"search_messages","arguments":{
"project_key":"/abs/path/backend","query":""build plan" AND users", "limit": 50
}}}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | Yes | ||
| format | No | ||
| agent_name | No | ||
| project_key | Yes | ||
| registration_token | No |