Connect Mural with Hookshot™ and your stack

Mural is a digital whiteboard platform enabling distributed teams to visually brainstorm, map ideas, and collaborate in real time with sticky notes and diagrams

Tools and triggers

What Agents can do in Mural

Available tools and events after Mural is connected.

  • Create Sticky Note

    Create one or more sticky note widgets on a mural. Each sticky note must be a properly structured object with required x and y coordinates. Pass the 'stickies' parameter as a direct array of objects - NOT strings, NOT…

  • Get Current User

    Tool to retrieve information about the currently authenticated user. Use when you need current user details after authentication.

  • Get Files for a Mural

    Tool to retrieve a list of file widgets in a mural. Use after confirming the mural ID when listing file attachments.

  • Get Mural Widgets

    Tool to retrieve all widgets within a specified mural. Widgets include sticky notes, text boxes, shapes, images, areas, arrows, icons, files, and comments. Use this after obtaining a valid mural ID from workspace…

  • Get Room by ID

    Tool to retrieve information about a specific room by its ID. Use when you need details about a particular room that the authenticated user has read access to.

  • Get Workspace by ID

    Tool to retrieve information about a specific workspace by its ID. Use when you need details about a particular workspace that the authenticated user has read access to.

  • Get Workspaces

    Tool to retrieve all workspaces the authenticated user is a member of. Use to list available workspaces before accessing rooms or murals.

  • List Default Templates

    Tool to retrieve all default templates available in Mural. Use when you need to browse or select from standard Mural templates.

  • List Folders in Room

    Tool to list all folders within a room that the authenticated user has access to. Use after MURAL_LIST_ROOMS to navigate folders within a specific room.

  • List Murals in Room

    Tool to list all murals for a room that the authenticated user has read access to. Use after getting a room ID to retrieve murals within that room.

  • List Open Rooms in Workspace

    Tool to list all discoverable open rooms within a workspace. Use when you need to access publicly available rooms in a workspace that don't require specific membership.

  • List Recent Murals in Workspace

    Tool to list recently opened active murals for the authenticated user in a workspace. Use after MURAL_LIST_WORKSPACES to view recent murals before opening or editing them.

  • List Recent Templates

    Tool to retrieve recent templates used by a user for a workspace. Use when you need to access recently used templates for creating new murals.

  • List Rooms in Workspace

    Tool to list all rooms within a workspace. Use after MURAL_LIST_WORKSPACES to navigate rooms and before MURAL_CREATE_MURAL, since murals are created within rooms.

  • List Tags in a Mural

    Tool to retrieve all tags in a mural. Use when you need to list or view tags associated with a specific mural.

  • List Users in Room

    Tool to list all members and guests for a room. Returns users that the authenticated user has access to view. Use after LIST_ROOMS to get room membership details.

  • List Workspace Murals

    Tool to list all murals in a workspace that the authenticated user owns or is a member of. Use after getting a workspace ID to browse available murals.

  • List Workspace Templates

    Tool to get default and custom templates for a workspace. Use when you need to list available templates after authentication.

  • MURAL Authorization Request

    Tool to initiate the OAuth 2.0 authorization process. Use when you need to redirect a user to Mural to obtain an authorization code.

  • Search Murals in Workspace

    Tool to search for murals within a workspace. Returns all murals that the authenticated user owns or is a member of for the specified workspace. Use when searching for specific murals by query text.

  • Search Rooms in Workspace

    Tool to search for rooms within a workspace by name or description. Returns all rooms that the authenticated user owns or is a member of matching the query. Use when you need to find specific rooms by search text.

  • Search Templates in Workspace

    Tool to search templates within a workspace that the authenticated user owns or has access to. Use when you need to find specific templates by name or keyword.

Setup

Connect Mural in Hookshot™

Pick a scope, then confirm what can start a Protege and what it can do.

Trigger Access

What can start a Protege from this app.

Tool Access

What a Protege can do after it starts.

Connection scope

Prefer team for production.

Team

Shared credential for production and unattended runs.

Personal

Tied to one user—only when the workflow needs their account.

Chat

Team-scoped for supported chat surfaces.

Full setup guide

Build with us

See Hookshot™ in your stack.

Request early access or book a live walkthrough with the team.

Request Demo
Hookshot™ setup screen — AI agent workflow configuration with model selection, trigger status, and governance controls.