TypeSafe MCP

by Renwang-Huang

Overview Schema Source Related Servers Discussions Admin

Python

Local

evaluate

Read-onlyIdempotent

Resolve bounded noul, choice, and score questions by supplying evidence and criteria to get typed Jev answers.

Instructions

USE WHEN you need raw typed Jev answers for one or more bounded noul, choice, or score questions. DO NOT USE WHEN you need prose, code generation, arithmetic, dates, or a specialized primitive such as route or gate.

Input Schema

TableJSON Schema

Name	Required	Description
`model`	No	Optional model id or alias.
`state`	Yes	Text or structured evidence.
`questions`	Yes	Map of question id to a TypeSafe question.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`model`	Yes
`usage`	Yes
`answers`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedv0.6.0Sep 21, 2026

changedInput schema / properties / questions / additionalProperties / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "criteria": {
-        "additionalProperties": false,
-        "properties": {
-          "false": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "object"
-              },
-              {
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "true": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "object"
-              },
-              {
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "instructions": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "object"
-          },
-          {
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "type": {
-        "const": "noul"
-      }
-    },
-    "required": [
-      "type",
-      "instructions"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "criteria": {
-        "additionalProperties": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "object"
-            },
-            {
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "maxProperties": 255,
-        "minProperties": 1,
-        "type": "object"
-      },
-      "instructions": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "object"
-          },
-          {
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "type": {
-        "const": "choice"
-      }
-    },
-    "required": [
-      "type",
-      "instructions",
-      "criteria"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "criteria": {
-        "items": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "object"
-            },
-            {
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "maxItems": 10,
-        "minItems": 2,
-        "type": "array"
-      },
-      "instructions": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "object"
-          },
-          {
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "type": {
-        "const": "score"
-      }
-    },
-    "required": [
-      "type",
-      "instructions",
-      "criteria"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "criteria": {
+        "additionalProperties": false,
+        "properties": {
+          "false": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object"
+              },
+              {
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "true": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object"
+              },
+              {
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "instructions": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object"
+          },
+          {
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "type": {
+        "const": "noul"
+      }
+    },
+    "required": [
+      "type",
+      "instructions"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "criteria": {
+        "additionalProperties": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object"
+            },
+            {
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "maxProperties": 255,
+        "minProperties": 1,
+        "type": "object"
+      },
+      "instructions": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object"
+          },
+          {
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "type": {
+        "const": "choice"
+      }
+    },
+    "required": [
+      "type",
+      "instructions",
+      "criteria"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "criteria": {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object"
+            },
+            {
+              "type": "array"
+            }
+          ]
+        },
+        "maxItems": 10,
+        "minItems": 2,
+        "type": "array"
+      },
+      "instructions": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object"
+          },
+          {
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "type": {
+        "const": "score"
+      }
+    },
+    "required": [
+      "type",
+      "instructions",
+      "criteria"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / questions / maxProperties
```
Added value: +64
```
addedInput schema / properties / questions / minProperties
```
Added value: +1
```

First observedv0.5.0Sep 21, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already establish read-only, idempotent, non-destructive behavior. The description adds that results are 'raw typed Jev answers' and that inputs are 'bounded' questions, giving useful behavioral context beyond the structured annotations.

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?

The description is compact and front-loaded: the primary use case appears first, followed immediately by explicit exclusions. Every sentence earns its place, and there is no redundant restatement of the schema.

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?

The tool is complex with nested question schemas and an output schema, but the description covers the main behavioral contract and routing. The undefined term 'Jev' and lack of detail on how state feeds questions are minor gaps that the schema and output schema mostly absorb.

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 the schema already documents model, state, and questions thoroughly. The description references question types but does not add parameter-level meaning beyond what the schema provides, which matches the baseline of 3.

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?

The description states exactly what the tool does: returns raw typed Jev answers for bounded noul, choice, or score questions. It distinguishes itself from specialized siblings by explicitly excluding route/gate-style primitives and prose/code-generation tasks.

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

Usage Guidelines5/5

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

The description gives explicit 'USE WHEN' and 'DO NOT USE WHEN' guidance, naming both the intended task class and the excluded alternatives. This makes the selection decision clear without requiring the agent to infer context.

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

Deploy Server