Skip to content
Docs menu

Tool reference · Tasks, workflows & decisions

list_intents

Lists recent user prompts, newest first, optionally filtered by project or session.

local stdio server read-only

When to use

  • You want to see what was asked in the last session.
  • You are reconstructing what a user was working on in one project.
  • You need prompt history without reading full transcripts.

Parameters

NameTypeDefaultDescription
project string — —
session_id string — —
limit integer 50 —

Example

Arguments

{
  "project": "reporting",
  "limit": 2
}

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…"
    },
    {
      "id": 1306,
      "session_id": "sess_2026_09_25_a",
      "project": "reporting",
      "prompt": "Show me the export job schedule",
      "created_at": "2026-09-25T08:39:02Z",
      "turn_index": 2,
      "prompt_hash": "4e7a21…"
    }
  ],
  "count": 2
}

At most 500 rows per call.

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:

List recent user prompts from the intents table, newest first. Filter by project and/or session. Max 500 rows.

Found a mistake? Open an issue on GitHub.

Search