Tool reference · Team server (remote)
memory_recall
Searches every workspace you can read, or just one scope, and returns ranked records labelled with the scope they came from.
team server /mcp
When to use
- Before starting work, to find what you or your teams already decided.
- You want results only from one team, by passing its scope.
- You need the id of a record before reading, editing or deleting it.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
queryrequired | string | — | (min length 1, max length 8,000) |
scope | { kind, team_id } | — | — |
project | string | — | (max length 128) |
limit | integer | 10 | (min 1, max 50) |
Example
Arguments
{
"query": "pgbouncer pool mode",
"project": "billing-api",
"limit": 5
}Result shape
{
"results": [
{
"scope": {
"kind": "team",
"team_id": "engineering"
},
"scope_tags": [
"scope:team",
"team:engineering"
],
"record": {
"id": 812,
"content": "Use pgbouncer in transaction mode for the billing API.",
"project": "billing-api",
"score": 0.912,
"created_by": {
"user_id": "vasya",
"display_name": "Vasya",
"client": "codex"
},
"updated_by": {
"user_id": "vasya",
"display_name": "Vasya",
"client": "codex"
},
"revision": 1
},
"scope_rank": 1
},
{
"scope": {
"kind": "personal",
"team_id": null
},
"scope_tags": [
"scope:personal"
],
"record": {
"id": 44,
"content": "pgbouncer session mode broke prepared statements locally",
"project": "billing-api",
"score": 0.604,
"created_by": {
"user_id": "vasya",
"display_name": "Vasya",
"client": "codex"
},
"updated_by": {
"user_id": "vasya",
"display_name": "Vasya",
"client": "codex"
},
"revision": 1
},
"scope_rank": 1
}
],
"ordering": "scope_rank_then_score"
}Results are interleaved: every scope’s best hit comes first, then every scope’s second hit, and so on, with score breaking ties. limit applies after merging. Record ids are only unique within their scope.
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 all accessible workspaces, or one selected scope.