Get Submissions Report is a WordPress ability from Fluent Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get Submissions Report
Read-onlyCross-form submission analytics for a date range — top forms by volume, plus busiest hours and weekdays.
Needs the Fluent Forms MCP server switched on in FluentForm → Settings → MCP, and WordPress 6.9+ so wp_register_ability() exists (abilities are only registered when the function is present). Reaching the server also requires a logged-in WordPress user holding at least one FluentForm capability. Each ability additionally checks a specific FluentForm capability (e.g. fluentform_dashboard_access, fluentform_forms_manager, fluentform_entries_viewer, fluentform_manage_entries, fluentform_view_payments, fluentform_settings_manager) via the plugin's own Acl system, and every write ability requires a two-step dry_run → confirm_token round-trip through WriteGuard before anything is persisted. Note (from source comments): a WordPress role granted FluentForm access via the Role Manager passes every per-ability capability check, including delete-submission and bulk delete_permanently — the real boundary for such a user is 'has FluentForm access, restricted to their form scope', not per-tool separation; only individually-assigned 'specific forms' managers are gated the way each ability's declared capability implies.
What it does
Aggregates submission analytics across a date range: total entries, the forms ranked by submission count (capped at the top 20, answering "which form got the most submissions"), and when entries arrive — a by_hour breakdown (0-23, site time) with the single peak_hour, and a by_weekday breakdown (Monday through Sunday) with the single peak_weekday. Scope to one form with form_id, or omit it to cover every form in the caller's access scope (returning an empty report rather than an error when that scope is empty). Uses three separate bounded SQL aggregates rather than one wide scan, so the result size never grows with the number of forms. Defaults to the last 30 days, capped at 366 days.
See it in action
You ask your AI assistant
"Which forms got the most submissions this month, and what's the busiest day and hour?"
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| form_id | integer | No | Optional. Omit to cover every form in your access scope. |
| date_from | string | No | YYYY-MM-DD (site timezone). Defaults to 30 days ago. The window may span at most 366 days. |
| date_to | string | No | YYYY-MM-DD (site timezone). Defaults to today. |
Returns
form_id (or null when aggregated), the date window, the total entry count, a top_forms leaderboard (form_id, title, count) capped at 20, a by_hour array (0-23) with peak_hour, and a by_weekday map with peak_weekday.
Permission
Requires the fluentform_entries_viewer or fluentform_dashboard_access capability.
More Fluent Forms abilities
Add Submission Note
Attach an internal staff note to one entry; not visible to the submitter.
Bulk Update Submissions
Apply one action — read, unread, trashed, favorite, unfavorite, or permanent delete — to up to 200 entries at once.
Create Form
Create a new form from a title and an ordered list of fields, or a basic contact form by default.
Create or Update Email Notification
Create a new email notification or update an existing one — including its recipient.
Delete Submission
Permanently delete one entry and its uploaded files.
Get Form
Load one form's full detail, including its field schema, so the agent knows the exact field keys used in submissions.