Subo

Create a project

create_project

Create a survey or poll. The project starts inactive and reaches nobody until open_project, or until delivery.opening.time when you schedule it (it then opens itself; confirm with the human first). Give it a script one of three ways, and only one: script.blocks written by you, intent for an AI draft (spends the community's credits; takes the same draft inputs as generate_script, and the response's draft.author_notes lists what to check before opening), or source_project_id to fork an existing project. privacy_mode defaults to the community's own default, which is often anonymous — set it explicitly if response identity matters. Read the subo://guide/authoring resource before writing blocks: block type names, section names and the piping rules are not guessable.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`name`	Yes
`plan`	No
`type`	Yes
`facts`	No
`intent`	No
`script`	No
`answers`	No
`quality`	No
`rewards`	No
`delivery`	No
`language`	No
`settings`	No
`max_blocks`	No
`session_id`	No
`presentation`	No
`privacy_mode`	No
`admin_language`	No
`question_count`	No
`scoring_enabled`	No
`source_project_id`	No
`max_completes_per_user`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedOct 15, 2026

changedInput schema / $defs / ActionConfigSchema / properties / fire_scope / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "respondent",
+      "session"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / AudienceRequest / properties / participation / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "private",
+      "open_web"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / AudienceRequest / properties / response_channel / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "discord",
+      "web"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / BlockOptionSchema / properties / anchor_position / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "const": "last",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / ClosingRequest / properties / mode / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "manual",
+      "scheduled"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / ContinueSchema / properties / after / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "pause",
+      "click"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / ContinueSchema / properties / pause / anyOf

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "minimum": 0,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / EmbedConfigRequest / properties / info_display / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "embed",
+      "button"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / InvitationRequest / properties / answer_button_color / anyOf

Previous value: -[
-  {
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maximum": 4,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / OpeningRequest / properties / mode / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "manual",
+      "scheduled"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / $defs / SettingsRequest / properties / poll_results_mode / anyOf

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "public",
+      "voters_only",
+      "hidden"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 8, 2026

addedInput schema / properties / admin_language

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Admin Language"
+}

Changed2 schema fields changedOct 6, 2026

addedInput schema / $defs / BlockSchema / properties / text_analysis

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Text Analysis"
+}

addedInput schema / $defs / SettingsRequest / properties / text_analysis

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Text Analysis"
+}

Changed7 schema fields changedOct 6, 2026

addedInput schema / properties / answers

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Answers"
+}

addedInput schema / properties / facts

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Facts"
+}

addedInput schema / properties / language

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Language"
+}

addedInput schema / properties / plan

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Plan"
+}

addedInput schema / properties / quality

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Quality"
+}

addedInput schema / properties / question_count

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Question Count"
+}

addedInput schema / properties / session_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Session Id"
+}

First observedOct 5, 2026

TDQS

A4.5/5.0

Behavior4/5

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

Annotations already declare non-read-only, non-destructive, non-idempotent, closed-world creation; the description adds genuinely new behavior: the created project reaches nobody until opened, the AI-draft path spends community credits, the response carries draft.author_notes to review, and ordering via delivery.opening.time is self-executing. It omits anything about permissions/errors, hence 4 rather than 5.

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

Conciseness4/5

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

Dense but front-loaded: creation semantics first, activation/scheduling second, script-sourcing third, parameter caveats last. Every sentence adds signal; the only cost is length, which is proportionate to a 21-parameter tool.

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

Completeness4/5

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

For a large, no-output-schema creation tool it covers lifecycle, script sourcing, credit cost, privacy default and the required pre-read of subo://guide/authoring. The main gap is the large set of untouched optional parameters, but the highest-risk decisions are all addressed.

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?

Schema description coverage is 0% across 21 parameters, so the description carries the burden — and it does cover the decision-critical ones: the three mutually exclusive script sources, privacy_mode's inheritance default and the anonymity risk, and delivery.opening.time. Many remaining params (plan, facts, answers, rewards, settings, presentation, quality, etc.) are still undocumented in both places, so it compensates well but not fully.

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

Purpose5/5

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

States a specific verb and resource ('Create a survey or poll') and immediately scopes it against siblings: it names open_project for activation, points at generate_script for draft inputs, and explains source_project_id as the fork alternative to clone-style flows. An agent can place this tool precisely among the 40+ siblings.

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?

Gives explicit when/when-not conditions: the project is inert until open_project or a scheduled delivery.opening.time, the human should confirm before scheduling, and the script must come from exactly one of three mutually exclusive sources. This is the rare case of full routing guidance.

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

All Subo tools Inspect

Try in Browser

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

Glama MCP Gateway

Add one secure layer between your agents and this server.

Create a project

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources