Skip to content

Why Agentful

Open-source agentic commerce

Run the shop. Keep core locked.

Agentful is a single-shop commerce app with a database-backed admin MCP surface, digest-pinned updates, and manifest-declared plugins. AI agents can manage products, orders, settings, reports, events, and approved plugins without gaining shell access or editing core source files.

Core app files

Source files are replaced by updates. Agents change runtime data and extension points, not patched React or NestJS internals.

Shop operations

Products, orders, refunds, users, settings, reports, and events are tool calls with scoped permissions and auditable database writes.

Extension surface

Plugins declare slots, pages, routes, MCP tools, event handlers, and owned tables before they can run.

Updates

Self-hosted upgrades use pinned image digests, migrations from the pinned API image, health checks, and automatic backups.

Agentful follows the open-closed principle at the shop boundary:

  • Open for runtime change through settings, theme tokens, content fields, products, orders, events, and plugins.
  • Closed for core edits because source patches are overwritten by the next signed and digest-pinned update.
  • Explicit about dangerous operations because deploy, restart, backup, and restore are not part of the default admin MCP token set.

That means a request like “make the footer Premier Studio text link to premierstudio.ai” is not a file edit. It is a settings change:

{
"content": {
"footerBrandUrl": "https://premierstudio.ai"
}
}

The value lives in the database, survives updates, and is reflected by the storefront without rebuilding the app.

Use Agentful Cloud

Premier Studio operates the runtime, backups, and update cadence. Each shop gets isolated data and the same MCP/plugin model as self-hosting.

Self-host

Run the full stack in Docker with Postgres and S3-compatible media storage. You own the host, env, backups, and update command.

Contribute

Work in the monorepo, keep shared schemas in sync, and use the CI gates before opening a pull request.

Agentful lives at PremierStudio/Agentful. The current internal package scope remains @shop/* while the public project name and documentation move to Agentful.