GovTribe
MCP tools

Show preferences panel MCP tool

Minimal: {"sections":[{"items":[{"id":"concise","label":"Concise answers","type":"switch"}]}]}. Render draft preferences. Only Save submits choices to the assistant; this is not a workspace-settings mutation API. Presentation ID defaults; titles, descriptions, section labels and Save label are optional. Preserve setting IDs and choice values; changing controls does not submit or apply settings. Confirm actual application separately after an authorized settings operation.

Examples

Use a preferences panel when the user should review several durable settings before the agent applies them.

Minimal working example

{
  "tool": "Show_Preferences_Panel",
  "arguments": {
    "sections": [
      {
        "items": [
          {
            "id": "concise",
            "label": "Concise answers",
            "type": "switch"
          }
        ]
      }
    ]
  }
}

The presentation id is generated when omitted or null. Titles, descriptions, section labels and the Save label are optional. Keep setting IDs and choice values stable: submitted values are keyed by them. A switch defaults to false; toggle/select controls use an explicit default or the first option. These are staged choices, not confirmation that settings have been applied.

Save is the only submission action on new panels. Changing a switch, toggle, or dropdown edits a draft; it does not submit choices. The styled dropdown supports arrow keys, Home/End, typing to find an option, Enter/Space to choose, and Escape to close without changing the selection. Tab closes it and moves focus onward.

Save records structured values through Interaction state and sends them to the assistant. This is not a general workspace-settings mutation API. Read the submitted values before any downstream work, retain authorization checks, and report settings as applied only when the actual operation confirms success. A completed interaction alone is not proof that settings changed.

If recording fails, the draft remains editable and Save can be retried. If choices were recorded but delivery to the assistant fails, the receipt explains the failure and offers Retry sending without making the values editable again. Reload restores the canonical receipt. Historical cancelled receipts remain readable, but new panels do not offer Cancel.

Let the user set saved-search notification preferences

{
  "tool": "Show_Preferences_Panel",
  "arguments": {
    "id": "saved-search-preferences",
    "title": "Saved search preferences",
    "description": "Set defaults for saved-search monitoring.",
    "summary": "These choices will guide future saved-search examples.",
    "sections": [
      {
        "label": "Notifications",
        "items": [
          {
            "id": "email-alerts",
            "label": "Email alerts",
            "description": "Receive email when matching records are found.",
            "type": "switch",
            "defaultChecked": true
          },
          {
            "id": "default-cadence",
            "label": "Default cadence",
            "type": "toggle",
            "options": [
              {
                "value": "Daily",
                "label": "Daily"
              },
              {
                "value": "Weekly",
                "label": "Weekly"
              },
              {
                "value": "Never",
                "label": "Never"
              }
            ],
            "defaultValue": "Weekly"
          }
        ]
      }
    ],
    "saveLabel": "Save preferences"
  }
}

Payload patterns

Use switch for binary preferences, toggle for short mutually exclusive choices, and select for longer option lists.

Ask for a default pipeline preference

{
  "tool": "Show_Preferences_Panel",
  "arguments": {
    "id": "pipeline-default-preferences",
    "title": "Pipeline defaults",
    "sections": [
      {
        "items": [
          {
            "id": "default-pipeline",
            "label": "Default pipeline",
            "type": "select",
            "selectOptions": [
              {
                "value": "federal-capture",
                "label": "Federal capture"
              },
              {
                "value": "state-local-capture",
                "label": "State and local capture"
              }
            ],
            "defaultSelected": "federal-capture"
          }
        ]
      }
    ]
  }
}

Show option list

Render a selectable option list that can send a user decision back to chat.

Show question flow

Render a multi-step guided flow that can send completed answers back to chat.

On this page

ExamplesMinimal working exampleLet the user set saved-search notification preferencesPayload patternsAsk for a default pipeline preferenceRelated articles