Skip to main content
Glama

AI Chat

ai
Read-only

Fastio AI chat (read): chats and their details, messages, a message's answer with citations, AI credit transactions. Workspace or share context. Writes are on ai_manage. action='describe' gives the full action/param reference.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindNochat-list filter: 'user' (default — user-driven chats), 'agent' (agentic chats), or 'all'.
waitNomessage-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). false: a single-shot status probe (one details fetch, ~1 round-trip), within strict ~30s client timeouts.
limitNochat-list/message-list page size. Forwarded best-effort: these endpoints document no paging and may return all rows.
actionYesOperation. Use 'describe' for full action reference.
detailNoVerbosity for chat-list/chat-details/message-list/message-details (best-effort server-side). Defaults: terse for lists, full for details. Levels: see describe.
offsetNochat-list/message-list offset (best-effort, see limit).
chat_idNoAI chat ID.
share_idNoprofile_id alias; implies profile_type=share.
context_idNoAlias for profile_id (either name works)
message_idNoAI message ID.
profile_idNo19-digit workspace or share ID (pair with profile_type). Aliases: workspace_id / share_id (imply the type), context_id, instance_id.
instance_idNoAlias for profile_id.
context_typeNoAlias for profile_type (either name works)
profile_typeNoProfile type: "workspace" or "share".
workspace_idNoprofile_id alias; implies profile_type=workspace.
include_deletedNochat-list: if true, list deleted chats via the /deleted variant (workspace AND share).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed17 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "ask",
      -  "status",
      -  "chat-create",
      -  "chat-list",
      -  "chat-details",
      -  "chat-update",
      -  "chat-delete",
      -  "chat-publish",
      -  "chat-cancel",
      -  "message-send",
      -  "message-list",
      -  "message-details",
      -  "message-read",
      -  "share-generate",
      -  "transactions"
      -]New value: +[
      +  "describe",
      +  "chat-list",
      +  "chat-details",
      +  "message-list",
      +  "message-details",
      +  "message-read",
      +  "transactions"
      +]
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for chat-list/chat-details/message-list/message-details (best-effort: chat/message/activity endpoints may not yet honor detail server-side). Defaults: terse for list-style (chat-list, message-list), full for details (chat-details, message-details). See action='describe' for per-level field lists."New value: +"Verbosity for chat-list/chat-details/message-list/message-details (best-effort server-side). Defaults: terse for lists, full for details. Levels: see describe."
    • removedInput schema / properties / files
      Removed value: -{
      -  "description": "File opaque IDs (max 25, share share-generate).",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • removedInput schema / properties / files_attach
      Removed value: -{
      -  "description": "Attach workspace FILES for the AI to read directly (comma-separated nodeId:versionId pairs; versionId optional → backend resolves current). Works regardless of workspace intelligence. A missing/inaccessible/ineligible node ERRORS (not a silent drop). See describe.",
      -  "type": "string"
      -}
    • removedInput schema / properties / folders_attach
      Removed value: -{
      -  "description": "Attach workspace FOLDERS for the AI to read (comma-separated folder nodeIds; no depth). Denied on restricted-view shares. See describe.",
      -  "type": "string"
      -}
    • changedInput schema / properties / instance_id / description
      Previous value: -"Alias for profile_id (REST/how-to name; profile_id is canonical)."New value: +"Alias for profile_id."
    • changedInput schema / properties / kind / description
      Previous value: -"chat-create (workspace only): 'user' (default) or 'agent' — flags the chat as agentic; set at creation, immutable; not accepted on share chats. chat-list: filter by 'user'|'agent'|'all'."New value: +"chat-list filter: 'user' (default — user-driven chats), 'agent' (agentic chats), or 'all'."
    • changedInput schema / properties / limit / description
      Previous value: -"chat-list/message-list page size. Best-effort: the AI API spec documents NO pagination on the chat-list or message-list endpoints (both return all rows under {count, items}), so this is forwarded but may be a silent no-op until the platform adds paging."New value: +"chat-list/message-list page size. Forwarded best-effort: these endpoints document no paging and may return all rows."
    • removedInput schema / properties / name
      Removed value: -{
      -  "description": "New chat name.",
      -  "type": "string"
      -}
    • removedInput schema / properties / node_ids
      Removed value: -{
      -  "description": "File node IDs (max 25, workspace share-generate).",
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • changedInput schema / properties / offset / description
      Previous value: -"chat-list/message-list pagination offset — see the limit caveat (no documented paging on these endpoints; forwarded best-effort)."New value: +"chat-list/message-list offset (best-effort, see limit)."
    • removedInput schema / properties / privacy
      Removed value: -{
      -  "description": "Chat privacy (default: private). Workspace chat-create only — share chats are always private.",
      -  "enum": [
      -    "private",
      -    "public"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / profile_id / description
      Previous value: -"Polymorphic context ID (pair with profile_type=workspace|share). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also context_id / instance_id. 19-digit workspace or share ID."New value: +"19-digit workspace or share ID (pair with profile_type). Aliases: workspace_id / share_id (imply the type), context_id, instance_id."
    • removedInput schema / properties / query_text
      Removed value: -{
      -  "description": "Question or prompt (max 32,000 chars).",
      -  "maxLength": 32000,
      -  "type": "string"
      -}
    • changedInput schema / properties / share_id / description
      Previous value: -"Alias for profile_id when the profile is a share — implies profile_type=share (so profile_type may be omitted)."New value: +"profile_id alias; implies profile_type=share."
    • changedInput schema / properties / wait / description
      Previous value: -"message-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). Set false for a single-shot status probe (one details fetch, ~1 round-trip) — useful against strict ~30s client timeouts."New value: +"message-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). false: a single-shot status probe (one details fetch, ~1 round-trip), within strict ~30s client timeouts."
    • changedInput schema / properties / workspace_id / description
      Previous value: -"Alias for profile_id when the profile is a workspace — implies profile_type=workspace (so profile_type may be omitted)."New value: +"profile_id alias; implies profile_type=workspace."
  2. Changed2 schema fields changed
    • changedInput schema / properties / query_text / description
      Previous value: -"Question or prompt (max 12,768 chars)."New value: +"Question or prompt (max 32,000 chars)."
    • changedInput schema / properties / query_text / maxLength
      Previous value: -12768New value: +32000
  3. Changed6 schema fields changed
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for chat-list/chat-details/message-list/message-details (best-effort: chat/message/activity endpoints may not yet honor detail…"New value: +"Per-entity verbosity for chat-list/chat-details/message-list/message-details (best-effort: chat/message/activity endpoints may not yet honor detail server-side). Defaults: terse for list-style (chat-list, message-list), full for details (chat-details, message-details). See action='describe' for per-level field lists."
    • changedInput schema / properties / files_attach / description
      Previous value: -"Attach workspace FILES for the AI to read directly (comma-separated nodeId:versionId pairs; versionId optional → backend resolves current). Works regardless of…"New value: +"Attach workspace FILES for the AI to read directly (comma-separated nodeId:versionId pairs; versionId optional → backend resolves current). Works regardless of workspace intelligence. A missing/inaccessible/ineligible node ERRORS (not a silent drop). See describe."
    • changedInput schema / properties / kind / description
      Previous value: -"chat-create (workspace only): 'user' (default) or 'agent' — flags the chat as agentic; set at creation, immutable; not accepted on share chats. chat-list:…"New value: +"chat-create (workspace only): 'user' (default) or 'agent' — flags the chat as agentic; set at creation, immutable; not accepted on share chats. chat-list: filter by 'user'|'agent'|'all'."
    • changedInput schema / properties / limit / description
      Previous value: -"chat-list/message-list page size. Best-effort: the AI API spec documents NO pagination on the chat-list or message-list endpoints (both return all rows under…"New value: +"chat-list/message-list page size. Best-effort: the AI API spec documents NO pagination on the chat-list or message-list endpoints (both return all rows under {count, items}), so this is forwarded but may be a silent no-op until the platform adds paging."
    • changedInput schema / properties / profile_id / description
      Previous value: -"Polymorphic context ID (pair with profile_type=workspace|share). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also…"New value: +"Polymorphic context ID (pair with profile_type=workspace|share). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also context_id / instance_id. 19-digit workspace or share ID."
    • changedInput schema / properties / wait / description
      Previous value: -"message-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). Set false for a single-shot status probe…"New value: +"message-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). Set false for a single-shot status probe (one details fetch, ~1 round-trip) — useful against strict ~30s client timeouts."
  4. Changed6 schema fields changed
    • changedInput schema / properties / files_attach / description
      Previous value: -"Attach files for direct AI analysis. See describe for limits."New value: +"Attach workspace FILES for the AI to read directly (comma-separated nodeId:versionId pairs; versionId optional → backend resolves current). Works regardless of…"
    • removedInput schema / properties / files_scope
      Removed value: -{
      -  "description": "Scope RAG to file versions. See describe for full constraints.",
      -  "type": "string"
      -}
    • addedInput schema / properties / folders_attach
      Added value: +{
      +  "description": "Attach workspace FOLDERS for the AI to read (comma-separated folder nodeIds; no depth). Denied on restricted-view shares. See describe.",
      +  "type": "string"
      +}
    • removedInput schema / properties / folders_scope
      Removed value: -{
      -  "description": "Scope RAG to folders via BFS. See describe for full constraints.",
      -  "type": "string"
      -}
    • removedInput schema / properties / personality
      Removed value: -{
      -  "description": "\"concise\" or \"detailed\" (default).",
      -  "enum": [
      -    "concise",
      -    "detailed"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / type
      Removed value: -{
      -  "description": "'chat' for general or 'chat_with_files' for file-grounded.",
      -  "enum": [
      -    "chat",
      -    "chat_with_files"
      -  ],
      -  "type": "string"
      -}
  5. Changed3 schema fields changed
    • changedInput schema / properties / profile_id / description
      Previous value: -"Polymorphic context ID. Pair with profile_type=workspace|share|org. Use workspace_id instead when only workspaces are valid. 19-digit workspace or share ID."New value: +"Polymorphic context ID (pair with profile_type=workspace|share). Typed aliases let you omit profile_type: workspace_id (⇒ workspace) / share_id (⇒ share); also…"
    • addedInput schema / properties / share_id
      Added value: +{
      +  "description": "Alias for profile_id when the profile is a share — implies profile_type=share (so profile_type may be omitted).",
      +  "type": "string"
      +}
    • addedInput schema / properties / workspace_id
      Added value: +{
      +  "description": "Alias for profile_id when the profile is a workspace — implies profile_type=workspace (so profile_type may be omitted).",
      +  "type": "string"
      +}
  6. Changed1 schema field changed
    • addedInput schema / properties / instance_id
      Added value: +{
      +  "description": "Alias for profile_id (REST/how-to name; profile_id is canonical).",
      +  "minLength": 1,
      +  "type": "string"
      +}
  7. Changed11 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "chat-create",
      -  "chat-list",
      -  "chat-details",
      -  "chat-update",
      -  "chat-delete",
      -  "chat-publish",
      -  "chat-cancel",
      -  "message-send",
      -  "message-list",
      -  "message-details",
      -  "message-read",
      -  "share-generate",
      -  "transactions",
      -  "autotitle"
      -]New value: +[
      +  "describe",
      +  "ask",
      +  "status",
      +  "chat-create",
      +  "chat-list",
      +  "chat-details",
      +  "chat-update",
      +  "chat-delete",
      +  "chat-publish",
      +  "chat-cancel",
      +  "message-send",
      +  "message-list",
      +  "message-details",
      +  "message-read",
      +  "share-generate",
      +  "transactions"
      +]
    • removedInput schema / properties / context
      Removed value: -{
      -  "description": "Optional user hint to guide AI generation.",
      -  "type": "string"
      -}
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for chat-list/chat-details/message-list/message-details. Defaults: terse for list-style (chat-list, message-list), full for details (chat-details, message-details). See action='describe' for per-level field lists."New value: +"Per-entity verbosity for chat-list/chat-details/message-list/message-details (best-effort: chat/message/activity endpoints may not yet honor detail…"
    • changedInput schema / properties / include_deleted / description
      Previous value: -"If true, list deleted chats (share only)."New value: +"chat-list: if true, list deleted chats via the /deleted variant (workspace AND share)."
    • addedInput schema / properties / kind
      Added value: +{
      +  "description": "chat-create (workspace only): 'user' (default) or 'agent' — flags the chat as agentic; set at creation, immutable; not accepted on share chats. chat-list:…",
      +  "enum": [
      +    "user",
      +    "agent",
      +    "all"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Results per page (1-500, default 100)."New value: +"chat-list/message-list page size. Best-effort: the AI API spec documents NO pagination on the chat-list or message-list endpoints (both return all rows under…"
    • changedInput schema / properties / name / description
      Previous value: -"New chat name (max 100 chars)."New value: +"New chat name."
    • changedInput schema / properties / offset / description
      Previous value: -"Pagination offset (default 0)."New value: +"chat-list/message-list pagination offset — see the limit caveat (no documented paging on these endpoints; forwarded best-effort)."
    • changedInput schema / properties / privacy / description
      Previous value: -"Chat privacy (default: public)."New value: +"Chat privacy (default: private). Workspace chat-create only — share chats are always private."
    • addedInput schema / properties / query_text / maxLength
      Added value: +12768
    • addedInput schema / properties / wait
      Added value: +{
      +  "description": "message-read only. Default true: bounded-wait for completion (up to ~24s on a workspace via the activity long-poll). Set false for a single-shot status probe…",
      +  "type": "boolean"
      +}
  8. Changed8 schema fields changed
    • removedInput schema / properties / limit / anyOf
      Removed value: -[
      -  {
      -    "maximum": 500,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / limit / maximum
      Added value: +500
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / limit / type
      Added value: +"integer"
    • removedInput schema / properties / offset / anyOf
      Removed value: -[
      -  {
      -    "maximum": 9007199254740991,
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / offset / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / offset / minimum
      Added value: +0
    • addedInput schema / properties / offset / type
      Added value: +"integer"
  9. Changed25 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Operation to perform"New value: +"Operation. Use 'describe' for full action reference."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "chat-create",
      -  "chat-list",
      -  "chat-details",
      -  "chat-update",
      -  "chat-delete",
      -  "chat-publish",
      -  "message-send",
      -  "message-list",
      -  "message-details",
      -  "message-read",
      -  "share-generate",
      -  "transactions",
      -  "autotitle"
      -]New value: +[
      +  "describe",
      +  "chat-create",
      +  "chat-list",
      +  "chat-details",
      +  "chat-update",
      +  "chat-delete",
      +  "chat-publish",
      +  "chat-cancel",
      +  "message-send",
      +  "message-list",
      +  "message-details",
      +  "message-read",
      +  "share-generate",
      +  "transactions",
      +  "autotitle"
      +]
    • changedInput schema / properties / chat_id / description
      Previous value: -"AI chat ID (required for: chat-details, chat-update, chat-delete, chat-publish, message-send, message-list, message-details, message-read)"New value: +"AI chat ID."
    • changedInput schema / properties / context / description
      Previous value: -"Optional user hint to guide AI generation (used by: autotitle)"New value: +"Optional user hint to guide AI generation."
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "Per-entity verbosity for chat-list/chat-details/message-list/message-details. Defaults: terse for list-style (chat-list, message-list), full for details (chat-details, message-details). See action='describe' for per-level field lists.",
      +  "enum": [
      +    "terse",
      +    "standard",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / files / description
      Previous value: -"File opaque IDs to include (max 25, share only) (required for: share-generate when profile_type=share)"New value: +"File opaque IDs (max 25, share share-generate)."
    • changedInput schema / properties / files_attach / description
      Previous value: -"Attach specific files for direct AI analysis — works regardless of workspace intelligence setting. FILES ONLY: passing a folder nodeId returns a 406 error. To include folder contents in AI context, use folders_scope instead (requires intelligence). Comma-separated nodeId:versionId pairs (nodeId required, versionId auto-resolved to current version if empty). Max 20 files, 200 MB total. Mutually exclusive with files_scope/folders_scope. Check ai.attach=true in storage details before using — files with ai.attach=false will be rejected. (used by: chat-create, message-send)"New value: +"Attach files for direct AI analysis. See describe for limits."
    • changedInput schema / properties / files_scope / description
      Previous value: -"Scope RAG search to specific file versions — REQUIRES workspace intelligence enabled (will error if intelligence is off). Comma-separated nodeId:versionId pairs (max 100 pairs). nodeId is required; versionId is auto-resolved to the current version if left empty (e.g., 'nodeId:' with nothing after the colon). Get versionId from storage list/details 'version' field. Do NOT enumerate folder contents as files_scope — use folders_scope with the folder's nodeId instead. OMIT this parameter to search all indexed files in the workspace (recommended default). Mutually exclusive with files_attach. (used by: chat-create, message-send)"New value: +"Scope RAG to file versions. See describe for full constraints."
    • changedInput schema / properties / folders_scope / description
      Previous value: -"Scope RAG search to specific folders — REQUIRES workspace intelligence enabled (will error if intelligence is off). Comma-separated nodeId:depth pairs (depth 1-10, max 100 subfolder refs). Use this to narrow AI context to folder contents without listing individual files — the RAG backend finds files within scoped folders automatically. OMIT to search all indexed files (recommended default). Mutually exclusive with files_attach. (used by: chat-create, message-send)"New value: +"Scope RAG to folders via BFS. See describe for full constraints."
    • changedInput schema / properties / include_deleted / description
      Previous value: -"If true, list deleted chats instead (share only) (used by: chat-list)"New value: +"If true, list deleted chats (share only)."
    • addedInput schema / properties / limit / anyOf
      Added value: +[
      +  {
      +    "maximum": 500,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / limit / description
      Previous value: -"Results per page, 1-500 (default 100) (used by: chat-list, message-list, search)"New value: +"Results per page (1-500, default 100)."
    • removedInput schema / properties / limit / type
      Removed value: -"number"
    • changedInput schema / properties / message_id / description
      Previous value: -"AI message ID (required for: message-details, message-read)"New value: +"AI message ID."
    • changedInput schema / properties / name / description
      Previous value: -"New name for the AI chat (max 100 chars) (required for: chat-update)"New value: +"New chat name (max 100 chars)."
    • changedInput schema / properties / node_ids / description
      Previous value: -"File node IDs to include (max 25, workspace only) (required for: share-generate when profile_type=workspace)"New value: +"File node IDs (max 25, workspace share-generate)."
    • addedInput schema / properties / offset / anyOf
      Added value: +[
      +  {
      +    "maximum": 9007199254740991,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / offset / description
      Previous value: -"Pagination offset (default 0) (used by: chat-list, message-list, search)"New value: +"Pagination offset (default 0)."
    • removedInput schema / properties / offset / type
      Removed value: -"number"
    • changedInput schema / properties / personality / description
      Previous value: -"Response style: \"concise\" (short, brief answers) or \"detailed\" (comprehensive with context and evidence, default). (used by: chat-create, message-send)"New value: +"\"concise\" or \"detailed\" (default)."
    • changedInput schema / properties / privacy / description
      Previous value: -"Chat privacy setting (default: public) (used by: chat-create)"New value: +"Chat privacy (default: public)."
    • changedInput schema / properties / profile_id / description
      Previous value: -"19-digit workspace or share ID (also accepted as context_id)"New value: +"Polymorphic context ID. Pair with profile_type=workspace|share|org. Use workspace_id instead when only workspaces are valid. 19-digit workspace or share ID."
    • changedInput schema / properties / profile_type / description
      Previous value: -"Profile type: \"workspace\" or \"share\" (also accepted as context_type)"New value: +"Profile type: \"workspace\" or \"share\"."
    • changedInput schema / properties / query_text / description
      Previous value: -"Question or prompt for chat-create / message-send (max 12,768 chars). (required for: chat-create (workspace), message-send)"New value: +"Question or prompt (max 12,768 chars)."
    • changedInput schema / properties / type / description
      Previous value: -"Chat type: 'chat' for general conversation, 'chat_with_files' for file-grounded analysis. With chat_with_files, omit scope parameters to search ALL indexed files in the workspace (recommended default). (required for: chat-create)"New value: +"'chat' for general or 'chat_with_files' for file-grounded."
  10. First observed

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered by structured data. The description reinforces the read-only nature and notes that answers carry citations, but adds little behavioral detail beyond the annotations (no rate limits, no pagination behavior). With annotations carrying the burden, a 3 is appropriate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the read scope and resource list, then the write-boundary, then the self-reference pointer. No wasted words despite covering a 7-action, 16-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a wide read tool with 16 parameters and no output schema, the description covers the domain, the read/write boundary, and defers detailed action semantics to action='describe', which is an effective completeness strategy. It does not explain return shapes for the citation or transaction actions, a minor gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 16 parameters — including the alias relationships and the `wait` long-poll semantics — are already documented in the schema. The description adds no parameter-level meaning beyond what the schema provides, only deferring to action='describe'. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific domain ('Fastio AI chat (read)') and enumerates the resources covered: chats and their details, messages, a message's answer with citations, and AI credit transactions. It explicitly marks the read scope and names the sibling that handles writes, so an agent can separate it from `ai_manage` without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes write operations to `ai_manage` and points to action='describe' for the full action/param reference, which is real usage guidance for a tool with seven actions. It stops short of saying when to pick each action (e.g. message-read vs message-details), so it is clear context without full exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources