Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Display builder tools

No security coverage Under active development

Let an AI agent build your Drupal pages.
Display Builder Tools gives an agent the tools a person uses in Display Builder: find a display, read the component catalog, place components with real content, then change, move or remove them.

  • Works with any agent that speaks MCP, such as Claude Code, through MCP Server.
  • The same tools serve Drush and the chat of Display Builder AI, built on Tool API.
  • The agent has its own account and the same access as a person: nothing it may not do in the Builder.
  • Every change is a draft in the Builder history, under the agent's name. A person publishes.

Project status

The 1.x branch is in beta: 1.0.0-beta1 needs Display Builder 1.0.0-beta10 or later, and Tool API 1.0.0-beta12 or later.

Requirements

  • Display Builder 1.0.0-beta10 or later
  • Tool API

Recommended modules

  • MCP Server and MCP Server Tool Bridge, to use the tools from a local agent. With the bridge enabled, every tool gets its MCP tool configuration.

Tools

  • Displays: display_builder_list_displays, display_builder_get_display_context, display_builder_get_current_display
  • Catalog: display_builder_get_available_components, display_builder_get_component_details, display_builder_get_prop_sources, display_builder_get_field_sources, display_builder_get_entity_fields, display_builder_get_ui_styles, display_builder_get_available_icons, display_builder_get_ui_skins (UI Skins), display_builder_get_views and display_builder_get_view_display (Views)
  • Changes: display_builder_create_page (Display Builder Page Layout), display_builder_add_component, display_builder_set_layout, display_builder_update_node, display_builder_move_node, display_builder_remove_node

A tool whose module is missing is not offered.

Configuration

  1. Create a Drupal account for the agent, with a role holding use display builder tools, the permission of each Display Builder profile it may use, such as use display builder default, and what a person needs to build those displays, such as administer page_layout for page layouts. Never run the agent as user 1: the account is what the history shows, and what limits the agent.

  2. At Configuration > Web services > Display Builder Tools, pick the profile of new pages and the components hidden from agents.

  3. Enable MCP Server and MCP Server Tool Bridge, then register the server in your agent. With Claude Code on a DDEV site, AGENT_ACCOUNT being the account name of step 1:

    claude mcp add drupal -- ddev drush mcp:server AGENT_ACCOUNT

The skill in .agents/skills/build-display tells an agent how to use the tools. Copy it where your agent reads skills.

Limits

  • Over MCP's STDIO transport, the tools write in the site's default language.
  • A display not built with Display Builder yet has no instance. A person enables Display Builder on it first.
  • An open Builder shows an agent's changes live only when its profile enables the Real-time collaboration island. Otherwise, reload the Builder.

Support

Support my open source work on Liberapay. Need a feature, a fix or help on your project? I take sponsored work and freelance missions: contact me.

Ask your assistant about Display builder tools

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
2
Tracked since
Nov 2026
Latest release
2 days ago
Releases (12 mo)
2 ▲ from 0
Maintenance
Active

Releases

Version Type Core PHP Release date
1.0.0-beta1 Pre-release 11 PHP >=8.3 Nov 20, 2026
1.x-dev Dev 11 PHP >=8.3 Nov 20, 2026