Documentation

list_tags

list_tags MCP tool reference, parameters, return type, and safety hints.

npm

What it does

Lists tags in the local Clovis ledger.

Signature(entity_type: string, entity_id: string) => Array<Record<string, unknown>>
read-only

Read-only. This is appropriate for inspection, reporting, diagnostics, and first-pass agent answers.

When to use it

Use this section to decide whether the tool fits the user request before calling it.

Use it when an agent needs to inspect the ledger or answer a question without changing records.

Before calling

Agents should gather these facts or confirmations first.

1

Have exact values for required inputs: entity_type, entity_id.

Parameters

Required inputs are marked clearly. Optional inputs can usually be omitted unless the workflow needs them.

entity_typerequired
string

Input used by this tool.

entity_idrequired
string

Entity id to filter reports when entity tracking is used.

Agent call shape

Use the exact tool name and pass arguments as structured JSON through the MCP client.

list_tags

Copy this shape into agent instructions, evals, or MCP client tests.

{
  "tool": "list_tags",
  "arguments": {
    "entity_type": "<entity_type>",
    "entity_id": "<entity_id>"
  }
}

Metadata