# Mural AI integration on Definable

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

## What this connects

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

Vendor: https://www.mural.co

## Tools available

**22** tools available. First 12:

- `MURAL_AUTHORIZATION_REQUEST` — 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.
- `MURAL_CREATE_STICKY_NOTE` — 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 nested objects. Example usage: { "muralId": "mural-id-here", "stickies": [ {"x": 100, "y": 200, "text": "First note"}, {"x": 300, "y": 400, "text": "Second note", "shape": "circle"} ] }
- `MURAL_GET_CURRENT_USER` — Get current user — Tool to retrieve information about the currently authenticated user. Use when you need current user details after authentication.
- `MURAL_GET_FILES_FOR_MURAL` — 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.
- `MURAL_GET_MURAL_WIDGETS` — 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 murals or other mural-related actions. Supports filtering by widget type, parent container, and pagination for large result sets.
- `MURAL_GET_ROOM` — 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.
- `MURAL_GET_WORKSPACE` — 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.
- `MURAL_GET_WORKSPACES` — Get workspaces — Tool to retrieve all workspaces the authenticated user is a member of. Use to list available workspaces before accessing rooms or murals.
- `MURAL_LIST_FOLDERS` — 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.
- `MURAL_LIST_OPEN_ROOMS` — 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.
- `MURAL_LIST_RECENT_MURALS` — 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.
- `MURAL_LIST_RECENT_TEMPLATES` — 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.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Mural

Inside a Definable workflow, Mural is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Mural** — the Researcher (GPT-5.5) pulls context from Mural (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Mural** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Mural (create record, post message, draft email).
- **Designer / Engineer → Distributor → Mural** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Mural (attach file, open PR comment, post status).

The Verifier checks every Mural call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- team collaboration — https://definable.ai/apps/category/team-collaboration/
- images & design — https://definable.ai/apps/category/images-&-design/

## Related

- HTML page: https://definable.ai/apps/mural/
- Same category (team collaboration): https://definable.ai/apps/category/team-collaboration/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt