UiChemy AI Website Creator

uichemy_set_button_role

Destructive

Make ONE button primary, secondary or a plain link — the per-button control, not the site-wide button design uichemy_set_button_design sets. The key is the button's own label slot (text_…), or its icon slot for an icon-only button; uichemy_get_page lists both against each button. That key is what the exported site resolves too, so this reaches WordPress and not just the canvas. A key belongs to the TEMPLATE, so the same button in a layout used on three pages changes on all three — the same way per-element text styling already behaves. Pass role: "reset" to put it back to whatever the template paints.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "projectId": "<projectId>",
      "buttonKey": "<buttonKey>",
      "role": "<role>"
    },
    "name": "uichemy_set_button_role"
  }
}

Input Schema

Name	Required	Description
`role`	Yes	"tertiary" is the one the panel calls Link.
`buttonKey`	Yes	A text_… or icon_url_… key, from uichemy_get_page.
`projectId`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 21, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare destructiveHint=true and readOnlyHint=false, and the description goes further by disclosing that a key belongs to the TEMPLATE so one change propagates to every page using that layout, and that the change reaches the exported WordPress site, not just the canvas. Those are exactly the mutation side-effects an agent needs; return format is the only omission, which the absence of an output schema makes minor.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four sentences, all carrying load, with the one-vs-site-wide distinction front-loaded. It is on the dense side but nothing is wasted and the ordering prioritizes the disambiguation first.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 3-param mutation tool with no output schema, the description covers what it mutates, where the key comes from, what scope the change applies to, and how to revert it. Only projectId's role and the persistence/export timing are left unstated, which are minor gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 67% and the description compensates: it explains that buttonKey is the button's own text_… or icon_url_… slot key sourced from uichemy_get_page, and clarifies role semantics. projectId is left implicit, but the key-sourcing detail is the piece an agent would otherwise get wrong.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (set one button's role) and immediately differentiates from the sibling uichemy_set_button_design, which is the site-wide design. An agent can distinguish the two without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly says this is the per-button control rather than the site-wide one, tells the agent where to get the key (uichemy_get_page lists label/icon slots) and names reset as the undo path. When-to-use and the alternative are both covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All UiChemy AI Website Creator tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?