Skip to content
Docs menu

Tool reference · Tasks, workflows & decisions

search_intents

Finds past user prompts that contain a given piece of text, newest first.

local stdio server read-only

When to use

  • You want to know when and how the user asked about a topic before.
  • A user says "like I asked last week" and you need that prompt.
  • You want exact-text matching rather than semantic search.

Parameters

NameTypeDefaultDescription
queryrequired string — Substring to match in prompt text
project string — —
limit integer 20 —

Example

Arguments

{
  "query": "export job",
  "project": "reporting",
  "limit": 5
}

Result shape

{
  "items": [
    {
      "id": 1307,
      "session_id": "sess_2026_09_25_a",
      "project": "reporting",
      "prompt": "Why does the nightly export job time out?",
      "created_at": "2026-09-25T08:41:17Z",
      "turn_index": 3,
      "prompt_hash": "9b1c0e…"
    }
  ],
  "count": 1
}

Plain substring (SQL LIKE) matching, not semantic search.

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:

Substring search over user prompts (LIKE). Returns newest match first. Useful for 'what did I ask about X' without mining transcripts.

Found a mistake? Open an issue on GitHub.

Search