How do I use SureForms's List Form Entries ability with AI?

Install the Easy MCP AI WordPress plugin alongside SureForms, connect your AI client, then ask in natural language — for example: "List the 20 most recent unread entries for form 42."

List Form Entries is a WordPress ability from SureForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

List Form Entries

Read-only

SureForms Forms sureforms/list-entries

List SureForms submission entries with filtering by form, status, date range, and search, plus pagination and sorting.

Requires the SureForms plugin on WordPress 6.9+ (the Abilities API is gated behind function_exists('wp_register_ability'), so it degrades gracefully on WP 6.4-6.8). Abilities only register when the 'srfm_abilities_api' option is enabled in SureForms' AI settings, and every ability requires the current user to have the 'manage_options' capability. Abilities that create or modify data additionally require the 'srfm_abilities_api_edit' option to not be explicitly disabled; abilities that permanently delete data additionally require 'srfm_abilities_api_delete' to not be explicitly disabled.

What it does

This ability lists form submission entries, optionally scoped to a form_id, filtered by status (all, read, unread, trash), a date_from/date_to range, or an entry-ID search, with configurable per_page (capped at 100), page, orderby (created_at, ID, form_id, status, language), and order (ASC/DESC). Each returned entry is enriched with its parent form's title and stripped of the heavier raw form_data payload to keep the response light. It lets an AI assistant triage recent submissions across one or all forms before pulling full detail on any specific entry.

See it in action

You ask your AI assistant

"List the 20 most recent unread entries for form 42."

Inputs

Name	Type	Required	Description
form_id	integer	No	Filter entries by form ID. Use 0 or omit for all forms. Defaults to 0.
status	string	No	Filter by status: all, read, unread, or trash. Defaults to all.
search	string	No	Search entries by entry ID.
date_from	string	No	Start date for filtering entries (YYYY-MM-DD).
date_to	string	No	End date for filtering entries (YYYY-MM-DD).
per_page	integer	No	Number of entries per page (1-100). Defaults to 20.
page	integer	No	Page number for pagination. Defaults to 1.
orderby	string	No	Column to order by: created_at, ID, form_id, status, or language. Defaults to created_at.
order	string	No	Sort direction: ASC or DESC. Defaults to DESC.

Returns

An object with an entries array (id, form_id, form_title, status, language, created_at per entry), plus total, total_pages, current_page, and per_page.

Permission

Requires the 'manage_options' capability, and the 'srfm_abilities_api' master option must be enabled. This ability has no additional gate option.

More SureForms abilities

Bulk Get Entry Details

Retrieve full submitted data for up to 50 SureForms entries in a single call.

Read-only

Create SureForms Form

Create a new SureForms form from a title, an array of field definitions, and optional metadata.

Write

Delete Entry

Permanently delete one or more SureForms submission entries.

Destructive

Delete SureForms Form

Move a SureForms form to trash, or permanently delete it when force is set.

Destructive

Duplicate SureForms Form

Clone an existing SureForms form, including its fields, metadata, and settings, as a new draft.

Write

Get Entry Details

Retrieve the full submitted data for a single SureForms entry, with field labels resolved.

Read-only