AI Ability · read

nibwp/wp-list-posts

A safe, side-effect-free call that returns structured, schema-typed data for wordpress — discoverable, permissioned and logged.

Overview

What wp-list-posts does

nibwp/wp-list-posts is a read ability: it looks up data and returns validated JSON without changing anything on your site. Filter and paginate the results, then chain them into write calls.

Parameters

NameTypeRequiredDescription
filtersobjectoptionalFilter the results by status, author, date or custom criteria.
per_pagenumberoptionalHow many items to return. Defaults to 20.
pagenumberoptionalPage number for pagination.
fieldsarrayoptionalLimit the response to specific fields.

Example call

tool: "nibwp/wp-list-posts" args: { filters: { status: "publish" }, per_page: 20 }
200 { items: [ … ], total: 42 }

What it can do

  • Return structured, schema-typed JSON
  • Filter, paginate and sort results
  • Safe and side-effect-free
  • Ready to chain into write calls
Safety

Powerful, but governed

Read-only

Side-effect-free — it never changes your data.

Audited

Each call is logged with status, latency, user and IP.

Rate limited

Per-token throttling stops runaway bulk operations.

Scoped tokens

Grant this tool only to the agents that should have it.

Related

Abilities that pair with it

FAQ

This ability, answered

What does it return?

A structured list or object with the requested data and a total count.

Is it logged?

Always — every call appears in the audit log with timing and the calling user.

Can I restrict it?

Yes — enable or disable it per token and restrict by category, post type, rate and IP.

Does it validate input?

Yes — every argument is checked against the JSON schema before anything runs.

See wp-list-posts run on a live site.

Book a demo and watch an agent call this ability through NibWP.