Teasa

Read the Teasa reply

get_turn

Read-onlyIdempotent

Read a previously submitted turn, without generating or charging again. Pending: wait a few seconds before polling. Completed: show image cards or the interactive app, with exact text fallback. nextPage fetches remaining image cards. Pass guestSession from start_story unless using OAuth. Only this connection’s conversations are accessible. Never create a fresh guest to bypass an exhausted allowance.

Input Schema

Name	Required	Description	Default
`page`	Yes
`output`	Yes		image
`turnId`	Yes
`guestSession`	No	Restricted guest credential returned by start_story. Retain privately and pass on every later call, retry and page. Never put it in a URL.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 24, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "branchId": {
+          "type": "string"
+        },
+        "branchVersion": {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "cards": {
+          "additionalProperties": false,
+          "properties": {
+            "nextPage": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "page": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "totalPages": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "page",
+            "totalPages"
+          ],
+          "type": "object"
+        },
+        "continueUrl": {
+          "type": "string"
+        },
+        "display": {
+          "items": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "const": "text",
+                    "type": "string"
+                  },
+                  "player": {
+                    "const": true,
+                    "type": "boolean"
+                  },
+                  "text": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "kind",
+                  "text"
+                ],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "enum": [
+                      "action",
+                      "narration"
+                    ],
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "kind",
+                  "text"
+                ],
+                "type": "object"
+              },
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "const": "page",
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "kind",
+                  "title",
+                  "url"
+                ],
+                "type": "object"
+              }
+            ]
+          },
+          "type": "array"
+        },
+        "guestExpiresAt": {
+          "type": "string"
+        },
+        "guestSession": {
+          "type": "string"
+        },
+        "language": {
+          "type": "string"
+        },
+        "presentation": {
+          "additionalProperties": false,
+          "properties": {
+            "cast": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "aliases": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "assetId": {
+                    "type": "string"
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "imageUrl": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "name"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "language": {
+              "type": "string"
+            },
+            "segments": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "kind": {
+                    "enum": [
+                      "narration",
+                      "dialogue",
+                      "action",
+                      "player_presentation"
+                    ],
+                    "type": "string"
+                  },
+                  "speakerId": {
+                    "type": "string"
+                  },
+                  "speakerIds": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "speakerLabel": {
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": "string"
+                  },
+                  "translationPending": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "speakerId",
+                  "kind",
+                  "text"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "text": {
+              "type": "string"
+            },
+            "title": {
+              "type": "string"
+            },
+            "version": {
+              "const": 1,
+              "type": "number"
+            }
+          },
+          "required": [
+            "version",
+            "title",
+            "language",
+            "text",
+            "segments",
+            "cast"
+          ],
+          "type": "object"
+        },
+        "rendering": {
+          "type": "string"
+        },
+        "retryAfterMs": {
+          "type": "number"
+        },
+        "status": {
+          "type": "string"
+        },
+        "threadId": {
+          "type": "string"
+        },
+        "turnId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "status",
+        "language",
+        "turnId",
+        "threadId",
+        "branchId",
+        "branchVersion"
+      ],
+      "type": "object"
+    },
+    {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "guestExpiresAt": {
+          "type": "string"
+        },
+        "guestSession": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "message",
+        "guestSession",
+        "guestExpiresAt"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}

First observedOct 13, 2026

TDQS

A4.1/5.0

Behavior5/5

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

Annotations already establish read-only, idempotent, closed-world behavior, and the description adds substantial operational context: no re-charge, polling timing, output presentation fallbacks, pagination, credential handling, connection scoping, and an allowance-abuse warning. There is no annotation conflict.

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

Conciseness4/5

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

Front-loads purpose and packs distinct operational guidance into short sentences with little filler. It is slightly dense and uses the undefined term 'nextPage,' which adds minor ambiguity.

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?

With annotations covering safety and an output schema covering return values, the description is nearly complete for calling the tool. It still omits where turnId comes from and how page indexing works.

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 only 25% (only guestSession is documented). The description adds real semantic meaning for output modes ('image cards', 'interactive app', 'exact text fallback') and credential source, and hints at pagination, but leaves turnId and the numeric page parameter largely unexplained; 'nextPage' also differs from the schema's 'page'.

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

Purpose4/5

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

The opening sentence gives a specific verb and resource ('Read a previously submitted turn') and explicitly rules out regeneration/charging, which separates it from send_message and start_story. It stops short of naming search_stories, so the contrast with sibling read tools is inferred rather than stated.

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?

Supplies concrete when-to-use guidance for pending vs completed states, polling delay, pagination via nextPage, and the guestSession/OAuth prerequisite. It also includes a when-not ('Never create a fresh guest...'), but does not explicitly route to sibling tools for discovery or creation.

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

All Teasa tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?