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_viewsanddisplay_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
-
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 asuse display builder default, and what a person needs to build those displays, such asadminister page_layoutfor page layouts. Never run the agent as user 1: the account is what the history shows, and what limits the agent. -
At Configuration > Web services > Display Builder Tools, pick the profile of new pages and the components hidden from agents.
-
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
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 |