Skip to main content
Glama

List form submissions

websiteForms_submissions_list
Read-onlyIdempotent

Returns submissions newest first as a cursor-paginated page. Filter by form name, status (inbox by default, or spam), and source (published for real visitors, draft for test submissions from the draft preview). Items carry the fields in submitted order, the inferred submitter email and name, page, spam signals, classifier verdict, and notification state. Submission data is personal information: never render it on the public website.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "websiteId": "<websiteId>"
    },
    "name": "websiteForms_submissions_list"
  }
}

Input Schema

NameRequiredDescriptionDefault
formNoOnly submissions of this form name.
limitNo
cursorNo
sourceNo`published` for real visitors, `draft` for test submissions from the draft preview.
statusNo`inbox` (default) or `spam`.
websiteIdYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already cover read-only, idempotent, and non-destructive behavior, so the bar is lower, yet the description still adds real context: newest-first ordering, cursor pagination, the default status, the shape of returned items, and a privacy constraint ('never render it on the public website'). It does not explain pagination termination (e.g., when the next cursor is absent) or any rate limits.

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?

Four sentences, front-loaded with the return semantics and filtering, ending with the safety-critical privacy note. Dense and mostly waste-free, though the middle sentence enumerating returned fields is long and slightly list-like.

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 no output schema and no annotations about data sensitivity, the description correctly compensates by enumerating returned item fields and flagging the personal-information constraint. The main residual gap is pagination mechanics (limit default 20, how to advance the cursor), which the agent must derive from the schema.

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

Parameters3/5

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

Schema description coverage is 50%: `form`, `status`, and `source` are documented in the schema, and the description largely restates those enum meanings verbatim rather than extending them. `limit`, `cursor`, and `websiteId` carry no description anywhere — the phrase 'cursor-paginated page' hints at `cursor` but gives no mechanics. Baseline 3 is appropriate given partial coverage.

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?

Opens with a specific verb and resource plus scope: 'Returns submissions newest first as a cursor-paginated page.' That clearly separates it from the sibling mutations (submissions_delete, submissions_setStatus) and the single-record submissions_get. It stops short of naming a sibling explicitly, so it lands just below the top of the scale.

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?

Filter semantics are explained well, including the default ('inbox by default') and what `published` vs `draft` mean, which tells an agent how to scope a call. However, there is no explicit when-to-use/when-not guidance relative to websiteForms_submissions_get or websiteForms_list — the agent must infer that this is the paged listing endpoint.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources