Skip to main content
Glama
Sign In

Problee

by com.problee
OverviewDiscussionsAdmin

Read dated market research and AI analyst takes

problee_get_market_research
Read-onlyIdempotent

Use this when someone asks what the AI analysts expect on a prediction-market question, or for its dated research. Read dated research, sources and published AI analyst takes for a binary market, or one option of a covered question; a question of several options without one: each option's AI analysts and price. Research, not advice.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "problee_get_market_research"
  }
}

Input Schema

NameRequiredDescriptionDefault
optionNoOne option instead: its condition id (0x…). Name the question or the option, not both.
addressNoChecksummed or lowercase 20-byte EVM address (0x + 40 hex).
chainIdNo
questionNoInstead of address: a covered question, mirrored or not, by its slug or its Kellian or Polymarket link.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • removedOutput schema / $defs
      Removed value: -{
-  "MarketResearch": {
-    "additionalProperties": false,
-    "properties": {
-      "analystCount": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "analystRecord": {
-        "additionalProperties": false,
-        "properties": {
-          "analystCloser": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "level": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "priceCloser": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "settledMarkets": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "max": {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  "min": {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  }
-                },
-                "required": [
-                  "min",
-                  "max"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tooFew": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "analystCloser",
-          "level",
-          "priceCloser",
-          "tooFew",
-          "settledMarkets"
-        ],
-        "type": "object"
-      },
-      "analysts": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "address": {
-              "pattern": "^0x[a-fA-F0-9]{40}$",
-              "type": "string"
-            },
-            "avatarUrl": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "displayName": {
-              "type": "string"
-            },
-            "position": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "outcome1": {
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    "outcome2": {
-                      "minimum": 0,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "outcome1",
-                    "outcome2"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "priceAtTake": {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            "probability": {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            "reason": {
-              "maxLength": 200,
-              "type": "string"
-            },
-            "scorecard": {
-              "additionalProperties": false,
-              "properties": {
-                "analystBrier": {
-                  "anyOf": [
-                    {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "marketBrier": {
-                  "anyOf": [
-                    {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "settledMarkets": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "settledTakes": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "verdict": {
-                  "enum": [
-                    "too_few",
-                    "analyst_closer",
-                    "price_closer",
-                    "level"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "settledMarkets",
-                "settledTakes",
-                "analystBrier",
-                "marketBrier",
-                "verdict"
-              ],
-              "type": "object"
-            },
-            "takenAt": {
-              "format": "date-time",
-              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-              "type": "string"
-            }
-          },
-          "required": [
-            "address",
-            "displayName",
-            "avatarUrl",
-            "probability",
-            "takenAt",
-            "priceAtTake",
-            "scorecard"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "analystsAverage": {
-        "anyOf": [
-          {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "analystsHolding": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "caseNo": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "caseYes": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "decides": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "facts": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "date": {
-              "format": "date",
-              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
-              "type": "string"
-            },
-            "sourceIds": {
-              "items": {
-                "exclusiveMinimum": 0,
-                "maximum": 9007199254740991,
-                "type": "integer"
-              },
-              "type": "array"
-            },
-            "text": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "date",
-            "text",
-            "sourceIds"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "priceAtResearch": {
-        "anyOf": [
-          {
-            "maximum": 1,
-            "minimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "researchedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "revision": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "at": {
-                "format": "date-time",
-                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                "type": "string"
-              },
-              "kind": {
-                "enum": [
-                  "corrected",
-                  "withdrawn"
-                ],
-                "type": "string"
-              },
-              "note": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "kind",
-              "at",
-              "note"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sources": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "host": {
-              "type": "string"
-            },
-            "id": {
-              "exclusiveMinimum": 0,
-              "maximum": 9007199254740991,
-              "type": "integer"
-            },
-            "title": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "url": {
-              "format": "uri",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "url",
-            "title",
-            "host"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "ready",
-          "none",
-          "excluded"
-        ],
-        "type": "string"
-      },
-      "version": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "watchNext": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "watchOut": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "status",
-      "version",
-      "researchedAt",
-      "priceAtResearch",
-      "decides",
-      "facts",
-      "watchNext",
-      "caseYes",
-      "caseNo",
-      "sources",
-      "analysts"
-    ],
-    "type": "object"
-  }
-}
    • removedOutput schema / properties / result / $ref
      Removed value: -"#/$defs/MarketResearch"
    • addedOutput schema / properties / result / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "analystCount": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "analystRecord": {
+        "additionalProperties": false,
+        "properties": {
+          "analystCloser": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "level": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "priceCloser": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "settledMarkets": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "max": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "min": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  }
+                },
+                "required": [
+                  "min",
+                  "max"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tooFew": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "analystCloser",
+          "level",
+          "priceCloser",
+          "tooFew",
+          "settledMarkets"
+        ],
+        "type": "object"
+      },
+      "analysts": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "address": {
+              "pattern": "^0x[a-fA-F0-9]{40}$",
+              "type": "string"
+            },
+            "avatarUrl": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "displayName": {
+              "type": "string"
+            },
+            "position": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "outcome1": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "outcome2": {
+                      "minimum": 0,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "outcome1",
+                    "outcome2"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "priceAtTake": {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "probability": {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            "reason": {
+              "maxLength": 200,
+              "type": "string"
+            },
+            "scorecard": {
+              "additionalProperties": false,
+              "properties": {
+                "analystBrier": {
+                  "anyOf": [
+                    {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "marketBrier": {
+                  "anyOf": [
+                    {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "settledMarkets": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "settledTakes": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "verdict": {
+                  "enum": [
+                    "too_few",
+                    "analyst_closer",
+                    "price_closer",
+                    "level"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "settledMarkets",
+                "settledTakes",
+                "analystBrier",
+                "marketBrier",
+                "verdict"
+              ],
+              "type": "object"
+            },
+            "takenAt": {
+              "format": "date-time",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "address",
+            "displayName",
+            "avatarUrl",
+            "probability",
+            "takenAt",
+            "priceAtTake",
+            "scorecard"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "analystsAverage": {
+        "anyOf": [
+          {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "analystsHolding": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "caseNo": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "caseYes": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "decides": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "facts": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "date": {
+              "format": "date",
+              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+              "type": "string"
+            },
+            "sourceIds": {
+              "items": {
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991,
+                "type": "integer"
+              },
+              "type": "array"
+            },
+            "text": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "date",
+            "text",
+            "sourceIds"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "priceAtResearch": {
+        "anyOf": [
+          {
+            "maximum": 1,
+            "minimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "researchedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "revision": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "at": {
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                "type": "string"
+              },
+              "kind": {
+                "enum": [
+                  "corrected",
+                  "withdrawn"
+                ],
+                "type": "string"
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "kind",
+              "at",
+              "note"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sources": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "host": {
+              "type": "string"
+            },
+            "id": {
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "url": {
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "url",
+            "title",
+            "host"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "enum": [
+          "ready",
+          "none",
+          "excluded"
+        ],
+        "type": "string"
+      },
+      "version": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "watchNext": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "watchOut": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "status",
+      "version",
+      "researchedAt",
+      "priceAtResearch",
+      "decides",
+      "facts",
+      "watchNext",
+      "caseYes",
+      "caseNo",
+      "sources",
+      "analysts"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "analystCount": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "analystsAverage": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "conditionId": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "price": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "conditionId",
+            "label",
+            "price",
+            "analystsAverage",
+            "analystCount"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "question": {
+        "additionalProperties": false,
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "slug",
+          "title",
+          "url"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "question",
+      "options"
+    ],
+    "type": "object"
+  }
+]
  2. Changed3 schema fields changed
    • addedInput schema / properties / option
      Added value: +{
+  "description": "One option instead: its condition id (0x…). Name the question or the option, not both.",
+  "pattern": "^0x[0-9a-fA-F]{64}$",
+  "type": "string"
+}
    • addedInput schema / properties / question
      Added value: +{
+  "description": "Instead of address: a covered question, mirrored or not, by its slug or its Kellian or Polymarket link.",
+  "maxLength": 2048,
+  "minLength": 1,
+  "type": "string"
+}
    • removedInput schema / required
      Removed value: -[
-  "address"
-]
  3. Changed1 schema field changed
    • addedOutput schema / $defs / MarketResearch / properties / watchOut
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
  4. Changed4 schema fields changed
    • addedOutput schema / $defs / MarketResearch / properties / analystRecord
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "analystCloser": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "level": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "priceCloser": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "settledMarkets": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "max": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "min": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "tooFew": {
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "analystCloser",
+    "level",
+    "priceCloser",
+    "tooFew",
+    "settledMarkets"
+  ],
+  "type": "object"
+}
    • addedOutput schema / $defs / MarketResearch / properties / analysts / items / properties / position
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "outcome1": {
+          "minimum": 0,
+          "type": "number"
+        },
+        "outcome2": {
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "outcome1",
+        "outcome2"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / $defs / MarketResearch / properties / analystsHolding
      Added value: +{
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}
    • addedOutput schema / $defs / MarketResearch / properties / revision
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "at": {
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+          "type": "string"
+        },
+        "kind": {
+          "enum": [
+            "corrected",
+            "withdrawn"
+          ],
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind",
+        "at",
+        "note"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
  5. Changed2 schema fields changed
    • addedOutput schema / $defs / MarketResearch / properties / analystCount
      Added value: +{
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}
    • addedOutput schema / $defs / MarketResearch / properties / analystsAverage
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
  6. Changed1 schema field changed
    • addedOutput schema / $defs / MarketResearch / properties / analysts / items / properties / reason
      Added value: +{
+  "maxLength": 200,
+  "type": "string"
+}
  7. Changed3 schema fields changed
    • removedOutput schema / $defs / MarketResearch / properties / analysts / items / properties / priceAtTake / multipleOf
      Removed value: -0.0001
    • removedOutput schema / $defs / MarketResearch / properties / analysts / items / properties / probability / multipleOf
      Removed value: -0.0001
    • changedOutput schema / $defs / MarketResearch / properties / priceAtResearch / anyOf
      Previous value: -[
-  {
-    "maximum": 1,
-    "minimum": 0,
-    "multipleOf": 0.0001,
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 1,
+    "minimum": 0,
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
  8. Added

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive, open-world access, so the safety profile is covered. The description adds that output includes dated research, sources and published takes, plus the disclaimer 'Research, not advice,' which is useful context. It says nothing about staleness, pagination, or what happens when no research has been published for a market.

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

Conciseness3/5

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

Short overall, and the trigger is front-loaded, but the second sentence is a run-on built from colon splices that take several reads to parse. The core fact — how the result changes for multi-option questions — is buried in the least parseable clause.

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

Completeness3/5

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

An output schema exists and annotations carry the safety profile, so the remaining burden is addressing semantics, which the description partially covers. The unresolved gap is the multi-option fallback behavior, which is the main thing an agent needs to predict the shape of the response and is described only ambiguously.

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

Parameters4/5

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

With 75% schema coverage the baseline is 3, and the description earns above that by explaining the mutually exclusive addressing modes: a market address, a question by slug or Kellian/Polymarket link, or a single option by condition id, and it states the implicit rule ('Name the question or the option, not both') that the schema only partially encodes. It still doesn't explain what chainId governs or when it is required.

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 description uses a specific verb+resource — 'Read dated research, sources and published AI analyst takes' for a binary market or one option — which distinguishes it from data-oriented siblings like problee_get_market_news or problee_get_question_forecasts. The second sentence's clause about multi-option questions is grammatically tangled ('a question of several options without one: each option's AI analysts and price'), leaving the fallback behavior somewhat opaque.

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

Usage Guidelines3/5

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

'Use this when someone asks what the AI analysts expect on a prediction-market question, or for its dated research' gives a clear trigger condition. However, no alternative tool is named or excluded, despite obvious candidates in the sibling list (get_question_forecasts, get_market_news, get_forecaster_record), so the agent must infer routing itself.

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

All Problee toolsInspect
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