# Mural — how to use (mcp.ai)

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

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mural?ms=1781542020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mural_create_sticky_note`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mural`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mural/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/mural/create/sticky/note` — Tool to create one or more sticky note widgets on a mural. use when you need to add notes to a mural layout.
  - body: { muralId: string, stickies: object[] }
- `POST https://api.mcp.ai/api/mural/get/current/user` — Tool to retrieve information about the currently authenticated user. use when you need current user details after authentication.
- `POST https://api.mcp.ai/api/mural/get/files/for/mural` — Tool to retrieve a list of file widgets in a mural. use after confirming the mural id when listing file attachments.
  - body: { next?: string, limit?: integer, muralId: string }
- `POST https://api.mcp.ai/api/mural/get/mural/widgets` — Tool to retrieve all widgets within a specified mural. use after confirming the mural id is correct.
  - body: { next?: string, type?: string[], limit?: integer, muralId: string, parentId?: string }
- `POST https://api.mcp.ai/api/mural/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.
  - body: { scope: string[], state?: string, client_id: string, redirect_uri: string, response_type?: string }

## More
- Page: https://mcp.ai/mural
- Agent spec (llms.txt): https://mcp.ai/mural/llms.txt
- Postman collection: https://mcp.ai/mural/postman.json