Skip to main content
Glama
Sign In

Problee

by com.problee
OverviewDiscussionsAdmin

Who holds and who moved on a Polymarket question, by smart money tier

problee_get_smart_money
Read-onlyIdempotent

Use this when someone asks who is buying or selling a prediction-market question, who holds it, or what smart money did. Smart money on a Polymarket question (its slug, event id or link) or one option (condition id): per open option, how many Tier 1-3 traders hold each side (Tier 1 = the topic's top 10 by profit, Tier 2 = the rest of its top list, Tier 3 = its next profitable traders), the best-ranked by name, and the last 24 hours of their trades from $1,000, counted by trader with the net side. Free: counts, and the moves a day late with no names. Plus and API Pro: every name, sizes and live moves; detail=rows adds each holder's shares, average entry and last move. Or a topic's Tier 1-3 list by profit (Free: 10 rows; Plus: 100). Information, not a signal. Past performance is not indicative of future results.

Input Schema

NameRequiredDescriptionDefault
topicNoOr a topic ("Movies · box office"), its slug or a word.
detailNo'rows': on Plus and API Pro, also each holder's shares, average entry and last move, and each move's shares. Free: ignored.
optionNoOne option instead: its condition id (0x…). Name the question or the option, not both.
questionNoA covered question: its slug or event id, or its Kellian or Polymarket link.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • changedInput schema / properties / question / description
      Previous value: -"A covered Polymarket question: its slug (polymarket.com/event/<slug>) or its event id."New value: +"A covered question: its slug or event id, or its Kellian or Polymarket link."
    • changedInput schema / properties / question / maxLength
      Previous value: -200New value: +2048
    • addedInput schema / properties / question / minLength
      Added value: +1
    • removedInput schema / properties / question / pattern
      Removed value: -"^[a-z0-9]+(?:-[a-z0-9]+)*$"
    • addedInput schema / properties / topic
      Added value: +{
+  "description": "Or a topic (\"Movies · box office\"), its slug or a word.",
+  "maxLength": 80,
+  "minLength": 1,
+  "type": "string"
+}
    • removedOutput schema / $defs
      Removed value: -{
-  "SmartMoneyResponse": {
-    "additionalProperties": false,
-    "properties": {
-      "live": {
-        "type": "boolean"
-      },
-      "moves": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "action": {
-              "enum": [
-                "bought",
-                "sold"
-              ],
-              "type": "string"
-            },
-            "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"
-            },
-            "conditionId": {
-              "type": "string"
-            },
-            "price": {
-              "anyOf": [
-                {
-                  "maximum": 1,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "shares": {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            "side": {
-              "enum": [
-                "outcome1",
-                "outcome2"
-              ],
-              "type": "string"
-            },
-            "tier": {
-              "anyOf": [
-                {
-                  "const": 1,
-                  "type": "number"
-                },
-                {
-                  "const": 2,
-                  "type": "number"
-                },
-                {
-                  "const": 3,
-                  "type": "number"
-                }
-              ]
-            },
-            "trader": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "name": {
-                      "type": "string"
-                    },
-                    "wallet": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "name",
-                    "wallet"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "usd": {
-              "anyOf": [
-                {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "required": [
-            "at",
-            "conditionId",
-            "tier",
-            "action",
-            "side",
-            "trader",
-            "usd",
-            "price"
-          ],
-          "type": "object"
-        },
-        "maxItems": 25,
-        "type": "array"
-      },
-      "notice": {
-        "const": "Past performance is not indicative of future results.",
-        "type": "string"
-      },
-      "options": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "chance": {
-              "anyOf": [
-                {
-                  "maximum": 1,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "conditionId": {
-              "minLength": 1,
-              "type": "string"
-            },
-            "flow": {
-              "additionalProperties": false,
-              "properties": {
-                "bought": {
-                  "items": {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  "maxItems": 2,
-                  "minItems": 2,
-                  "type": "array"
-                },
-                "net": {
-                  "anyOf": [
-                    {
-                      "enum": [
-                        "outcome1",
-                        "outcome2"
-                      ],
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "sold": {
-                  "items": {
-                    "maximum": 9007199254740991,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  "maxItems": 2,
-                  "minItems": 2,
-                  "type": "array"
-                },
-                "traders": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "usd": {
-                  "anyOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "bought": {
-                          "items": {
-                            "minimum": 0,
-                            "type": "number"
-                          },
-                          "maxItems": 2,
-                          "minItems": 2,
-                          "type": "array"
-                        },
-                        "sold": {
-                          "items": {
-                            "minimum": 0,
-                            "type": "number"
-                          },
-                          "maxItems": 2,
-                          "minItems": 2,
-                          "type": "array"
-                        }
-                      },
-                      "required": [
-                        "bought",
-                        "sold"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "traders",
-                "bought",
-                "sold",
-                "net",
-                "usd"
-              ],
-              "type": "object"
-            },
-            "holders": {
-              "anyOf": [
-                {
-                  "additionalProperties": false,
-                  "properties": {
-                    "asOf": {
-                      "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"
-                    },
-                    "names": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "outcome1": {
-                          "items": {
-                            "additionalProperties": false,
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "rank": {
-                                "exclusiveMinimum": 0,
-                                "maximum": 9007199254740991,
-                                "type": "integer"
-                              },
-                              "tier": {
-                                "anyOf": [
-                                  {
-                                    "const": 1,
-                                    "type": "number"
-                                  },
-                                  {
-                                    "const": 2,
-                                    "type": "number"
-                                  },
-                                  {
-                                    "const": 3,
-                                    "type": "number"
-                                  }
-                                ]
-                              },
-                              "wallet": {
-                                "pattern": "^0x[0-9a-f]{40}$",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "wallet",
-                              "name",
-                              "tier"
-                            ],
-                            "type": "object"
-                          },
-                          "type": "array"
-                        },
-                        "outcome2": {
-                          "items": {
-                            "additionalProperties": false,
-                            "properties": {
-                              "name": {
-                                "type": "string"
-                              },
-                              "rank": {
-                                "exclusiveMinimum": 0,
-                                "maximum": 9007199254740991,
-                                "type": "integer"
-                              },
-                              "tier": {
-                                "anyOf": [
-                                  {
-                                    "const": 1,
-                                    "type": "number"
-                                  },
-                                  {
-                                    "const": 2,
-                                    "type": "number"
-                                  },
-                                  {
-                                    "const": 3,
-                                    "type": "number"
-                                  }
-                                ]
-                              },
-                              "wallet": {
-                                "pattern": "^0x[0-9a-f]{40}$",
-                                "type": "string"
-                              }
-                            },
-                            "required": [
-                              "wallet",
-                              "name",
-                              "tier"
-                            ],
-                            "type": "object"
-                          },
-                          "type": "array"
-                        }
-                      },
-                      "required": [
-                        "outcome1",
-                        "outcome2"
-                      ],
-                      "type": "object"
-                    },
-                    "tier1": {
-                      "items": {
-                        "maximum": 9007199254740991,
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "maxItems": 2,
-                      "minItems": 2,
-                      "type": "array"
-                    },
-                    "tier2": {
-                      "items": {
-                        "maximum": 9007199254740991,
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "maxItems": 2,
-                      "minItems": 2,
-                      "type": "array"
-                    },
-                    "tier3": {
-                      "items": {
-                        "maximum": 9007199254740991,
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      "maxItems": 2,
-                      "minItems": 2,
-                      "type": "array"
-                    }
-                  },
-                  "required": [
-                    "tier1",
-                    "tier2",
-                    "tier3",
-                    "names",
-                    "asOf"
-                  ],
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "label": {
-              "type": "string"
-            },
-            "outcomes": {
-              "items": {
-                "type": "string"
-              },
-              "maxItems": 2,
-              "minItems": 2,
-              "type": "array"
-            },
-            "rows": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "entryAt": {
-                    "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"
-                      }
-                    ]
-                  },
-                  "entryPrice": {
-                    "anyOf": [
-                      {
-                        "maximum": 1,
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "lastMove": {
-                    "anyOf": [
-                      {
-                        "additionalProperties": false,
-                        "properties": {
-                          "action": {
-                            "enum": [
-                              "bought",
-                              "sold"
-                            ],
-                            "type": "string"
-                          },
-                          "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"
-                          },
-                          "side": {
-                            "enum": [
-                              "outcome1",
-                              "outcome2"
-                            ],
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "action",
-                          "side",
-                          "at"
-                        ],
-                        "type": "object"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "rank": {
-                    "exclusiveMinimum": 0,
-                    "maximum": 9007199254740991,
-                    "type": "integer"
-                  },
-                  "shares": {
-                    "exclusiveMinimum": 0,
-                    "maximum": 9007199254740991,
-                    "type": "integer"
-                  },
-                  "side": {
-                    "enum": [
-                      "outcome1",
-                      "outcome2"
-                    ],
-                    "type": "string"
-                  },
-                  "tier": {
-                    "anyOf": [
-                      {
-                        "const": 1,
-                        "type": "number"
-                      },
-                      {
-                        "const": 2,
-                        "type": "number"
-                      },
-                      {
-                        "const": 3,
-                        "type": "number"
-                      }
-                    ]
-                  },
-                  "wallet": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "wallet",
-                  "name",
-                  "tier",
-                  "side",
-                  "shares",
-                  "entryPrice",
-                  "entryAt",
-                  "lastMove"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            }
-          },
-          "required": [
-            "conditionId",
-            "label",
-            "outcomes",
-            "chance",
-            "holders",
-            "flow"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "plan": {
-        "enum": [
-          "free_preview",
-          "plus",
-          "api_pro"
-        ],
-        "type": "string"
-      },
-      "question": {
-        "additionalProperties": false,
-        "properties": {
-          "eventId": {
-            "type": "string"
-          },
-          "polymarket": {
-            "format": "uri",
-            "type": "string"
-          },
-          "slug": {
-            "type": "string"
-          },
-          "title": {
-            "type": "string"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          }
-        },
-        "required": [
-          "eventId",
-          "slug",
-          "title",
-          "url",
-          "polymarket"
-        ],
-        "type": "object"
-      },
-      "quietOptions": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "unreadOptions": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "window": {
-        "additionalProperties": false,
-        "properties": {
-          "from": {
-            "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"
-          },
-          "until": {
-            "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": [
-          "from",
-          "until"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "question",
-      "live",
-      "window",
-      "options",
-      "quietOptions",
-      "unreadOptions",
-      "moves",
-      "plan",
-      "notice"
-    ],
-    "type": "object"
-  }
-}
    • removedOutput schema / properties / result / $ref
      Removed value: -"#/$defs/SmartMoneyResponse"
    • addedOutput schema / properties / result / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "live": {
+        "type": "boolean"
+      },
+      "moves": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "action": {
+              "enum": [
+                "bought",
+                "sold"
+              ],
+              "type": "string"
+            },
+            "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"
+            },
+            "conditionId": {
+              "type": "string"
+            },
+            "price": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "shares": {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            "side": {
+              "enum": [
+                "outcome1",
+                "outcome2"
+              ],
+              "type": "string"
+            },
+            "tier": {
+              "anyOf": [
+                {
+                  "const": 1,
+                  "type": "number"
+                },
+                {
+                  "const": 2,
+                  "type": "number"
+                },
+                {
+                  "const": 3,
+                  "type": "number"
+                }
+              ]
+            },
+            "trader": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "wallet": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "name",
+                    "wallet"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "usd": {
+              "anyOf": [
+                {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "required": [
+            "at",
+            "conditionId",
+            "tier",
+            "action",
+            "side",
+            "trader",
+            "usd",
+            "price"
+          ],
+          "type": "object"
+        },
+        "maxItems": 25,
+        "type": "array"
+      },
+      "notice": {
+        "const": "Past performance is not indicative of future results.",
+        "type": "string"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "chance": {
+              "anyOf": [
+                {
+                  "maximum": 1,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "conditionId": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "flow": {
+              "additionalProperties": false,
+              "properties": {
+                "bought": {
+                  "items": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "maxItems": 2,
+                  "minItems": 2,
+                  "type": "array"
+                },
+                "net": {
+                  "anyOf": [
+                    {
+                      "enum": [
+                        "outcome1",
+                        "outcome2"
+                      ],
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "sold": {
+                  "items": {
+                    "maximum": 9007199254740991,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "maxItems": 2,
+                  "minItems": 2,
+                  "type": "array"
+                },
+                "traders": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "usd": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "bought": {
+                          "items": {
+                            "minimum": 0,
+                            "type": "number"
+                          },
+                          "maxItems": 2,
+                          "minItems": 2,
+                          "type": "array"
+                        },
+                        "sold": {
+                          "items": {
+                            "minimum": 0,
+                            "type": "number"
+                          },
+                          "maxItems": 2,
+                          "minItems": 2,
+                          "type": "array"
+                        }
+                      },
+                      "required": [
+                        "bought",
+                        "sold"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": [
+                "traders",
+                "bought",
+                "sold",
+                "net",
+                "usd"
+              ],
+              "type": "object"
+            },
+            "holders": {
+              "anyOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "asOf": {
+                      "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"
+                    },
+                    "names": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "outcome1": {
+                          "items": {
+                            "additionalProperties": false,
+                            "properties": {
+                              "name": {
+                                "type": "string"
+                              },
+                              "rank": {
+                                "exclusiveMinimum": 0,
+                                "maximum": 9007199254740991,
+                                "type": "integer"
+                              },
+                              "tier": {
+                                "anyOf": [
+                                  {
+                                    "const": 1,
+                                    "type": "number"
+                                  },
+                                  {
+                                    "const": 2,
+                                    "type": "number"
+                                  },
+                                  {
+                                    "const": 3,
+                                    "type": "number"
+                                  }
+                                ]
+                              },
+                              "wallet": {
+                                "pattern": "^0x[0-9a-f]{40}$",
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "wallet",
+                              "name",
+                              "tier"
+                            ],
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "outcome2": {
+                          "items": {
+                            "additionalProperties": false,
+                            "properties": {
+                              "name": {
+                                "type": "string"
+                              },
+                              "rank": {
+                                "exclusiveMinimum": 0,
+                                "maximum": 9007199254740991,
+                                "type": "integer"
+                              },
+                              "tier": {
+                                "anyOf": [
+                                  {
+                                    "const": 1,
+                                    "type": "number"
+                                  },
+                                  {
+                                    "const": 2,
+                                    "type": "number"
+                                  },
+                                  {
+                                    "const": 3,
+                                    "type": "number"
+                                  }
+                                ]
+                              },
+                              "wallet": {
+                                "pattern": "^0x[0-9a-f]{40}$",
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "wallet",
+                              "name",
+                              "tier"
+                            ],
+                            "type": "object"
+                          },
+                          "type": "array"
+                        }
+                      },
+                      "required": [
+                        "outcome1",
+                        "outcome2"
+                      ],
+                      "type": "object"
+                    },
+                    "tier1": {
+                      "items": {
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "maxItems": 2,
+                      "minItems": 2,
+                      "type": "array"
+                    },
+                    "tier2": {
+                      "items": {
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "maxItems": 2,
+                      "minItems": 2,
+                      "type": "array"
+                    },
+                    "tier3": {
+                      "items": {
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      "maxItems": 2,
+                      "minItems": 2,
+                      "type": "array"
+                    }
+                  },
+                  "required": [
+                    "tier1",
+                    "tier2",
+                    "tier3",
+                    "names",
+                    "asOf"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "label": {
+              "type": "string"
+            },
+            "outcomes": {
+              "items": {
+                "type": "string"
+              },
+              "maxItems": 2,
+              "minItems": 2,
+              "type": "array"
+            },
+            "rows": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "entryAt": {
+                    "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"
+                      }
+                    ]
+                  },
+                  "entryPrice": {
+                    "anyOf": [
+                      {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "lastMove": {
+                    "anyOf": [
+                      {
+                        "additionalProperties": false,
+                        "properties": {
+                          "action": {
+                            "enum": [
+                              "bought",
+                              "sold"
+                            ],
+                            "type": "string"
+                          },
+                          "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"
+                          },
+                          "side": {
+                            "enum": [
+                              "outcome1",
+                              "outcome2"
+                            ],
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "action",
+                          "side",
+                          "at"
+                        ],
+                        "type": "object"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "rank": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "shares": {
+                    "exclusiveMinimum": 0,
+                    "maximum": 9007199254740991,
+                    "type": "integer"
+                  },
+                  "side": {
+                    "enum": [
+                      "outcome1",
+                      "outcome2"
+                    ],
+                    "type": "string"
+                  },
+                  "tier": {
+                    "anyOf": [
+                      {
+                        "const": 1,
+                        "type": "number"
+                      },
+                      {
+                        "const": 2,
+                        "type": "number"
+                      },
+                      {
+                        "const": 3,
+                        "type": "number"
+                      }
+                    ]
+                  },
+                  "wallet": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "wallet",
+                  "name",
+                  "tier",
+                  "side",
+                  "shares",
+                  "entryPrice",
+                  "entryAt",
+                  "lastMove"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "conditionId",
+            "label",
+            "outcomes",
+            "chance",
+            "holders",
+            "flow"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "plan": {
+        "enum": [
+          "free_preview",
+          "plus",
+          "api_pro"
+        ],
+        "type": "string"
+      },
+      "question": {
+        "additionalProperties": false,
+        "properties": {
+          "eventId": {
+            "type": "string"
+          },
+          "polymarket": {
+            "format": "uri",
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "eventId",
+          "slug",
+          "title",
+          "url",
+          "polymarket"
+        ],
+        "type": "object"
+      },
+      "quietOptions": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "unreadOptions": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "window": {
+        "additionalProperties": false,
+        "properties": {
+          "from": {
+            "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"
+          },
+          "until": {
+            "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": [
+          "from",
+          "until"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "question",
+      "live",
+      "window",
+      "options",
+      "quietOptions",
+      "unreadOptions",
+      "moves",
+      "plan",
+      "notice"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "notice": {
+        "const": "Past performance is not indicative of future results.",
+        "type": "string"
+      },
+      "plan": {
+        "enum": [
+          "free_preview",
+          "plus",
+          "api_pro"
+        ],
+        "type": "string"
+      },
+      "tiers": {
+        "additionalProperties": false,
+        "properties": {
+          "tier1": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "tier2": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "tier3": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "tier1",
+          "tier2",
+          "tier3"
+        ],
+        "type": "object"
+      },
+      "topic": {
+        "type": "string"
+      },
+      "traders": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "profitUsd": {
+              "type": "number"
+            },
+            "rank": {
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            "tier": {
+              "anyOf": [
+                {
+                  "const": 1,
+                  "type": "number"
+                },
+                {
+                  "const": 2,
+                  "type": "number"
+                },
+                {
+                  "const": 3,
+                  "type": "number"
+                }
+              ]
+            },
+            "traderReference": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "traderReference",
+            "rank",
+            "tier",
+            "profitUsd"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "url": {
+        "format": "uri",
+        "type": "string"
+      },
+      "window": {
+        "additionalProperties": false,
+        "properties": {
+          "days": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "from": {
+            "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": [
+          "from",
+          "days"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "topic",
+      "url",
+      "window",
+      "tiers",
+      "traders",
+      "plan",
+      "notice"
+    ],
+    "type": "object"
+  }
+]
  2. Added

TDQS

A4/5.0
Behavior5/5

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

Well beyond the readOnly/idempotent annotations, it discloses tier definitions (Tier 1 = topic's top 10 by profit, etc.), the 24-hour window, the $1,000 minimum trade size, and — crucially — plan-gated behavior: Free gets counts and day-late unnamed moves, Plus/API Pro get names, sizes and live moves, with detail=rows adding shares, average entry and last move. It also flags the Free 10-row vs Plus 100-row limit, which is exactly the kind of access and freshness constraint an agent needs before calling.

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?

The trigger clause is correctly front-loaded, but the body is a dense multi-clause run-on that interleaves tier definitions, plan gating, parameter behavior and caveats. The closing 'Information, not a signal. Past performance is not indicative of future results' is a compliance disclaimer that does not help an agent decide or call correctly.

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 an output schema present, return values need not be explained, and the description covers tier semantics, freshness, size thresholds and plan limits thoroughly. The one gap is that all four parameters are optional yet the description never says what happens with no question/topic/option supplied, nor how topic mode differs from question mode in output shape.

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 coverage is 100%, so the schema already documents question (slug/event id/link), option (condition id), topic and detail. The description reinforces mutual exclusivity and the detail=rows payload, but adds little format or constraint detail the schema does not already carry; baseline 3 applies.

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 states a concrete resource and scope: per open option, the Tier 1-3 holder counts per side, the best-ranked holder names, and the last 24h of trades from $1,000 with net side, plus a topic-mode tier list. It is clearly distinct in substance from generic siblings like problee_get_market_holders or problee_get_moving, but it never names those siblings, so the differentiation must be inferred from the tier/threshold language.

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?

Opens with an explicit trigger: 'Use this when someone asks who is buying or selling a prediction-market question, who holds it, or what smart money did,' and then covers the alternate topic-mode use. It gives clear when-to-use context but no when-not-to-use or named alternative tool for plain holder lists.

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