Tool reference · Save & recall
memory_search_by_tag
Lists all active records whose tags contain the given text.
local stdio server read-only
When to use
- You want to browse everything filed under a category such as "database" or "reusable".
- You need an exact tag-based list rather than a relevance-ranked search.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
tagrequired | string | — | Tag to search for (partial match) |
project | string | — | Filter by project (optional) |
Example
Arguments
{
"tag": "database",
"project": "my-api"
}Result shape
{
"tag": "database",
"total": 2,
"records": [
{
"id": 1842,
"content": "Use PostgreSQL advisory locks for the nightly billing job instead of a Redis lock.",
"type": "decision",
"project": "my-api",
"tags": [
"database",
"billing"
],
"created_at": "2026-09-20T10:14:03Z"
}
]
}Matching is partial, so "data" also matches "database". Content is cut to 200 characters.
Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
Search knowledge by tag. Returns all active records with matching tag (partial match). Useful for categorical browsing.