# list_plotwork_diagrams

> Page: https://docs.flung.dev/mcp/tools/list-plotwork-diagrams. Index of every page: https://docs.flung.dev/llms.txt

List Plotwork diagrams. The diagrams of the Plotwork account the workspace connected, newest first, with q to match names. For attach_plotwork_diagram. plotwork_not_connected means a person must connect Plotwork in the Flung portal, under Integrations.

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | The diagrams of the Plotwork account the workspace connected, newest first, with q to match names. For attach_plotwork_diagram. plotwork_not_connected means a person must connect Plotwork in the Flung portal, under Integrations. |
| Does it change anything? | Reads only. |
| Which endpoint does it call? | [`GET /v1/plotwork/diagrams`](https://docs.flung.dev/reference/api/get-v1-plotwork-diagrams.md) |
| Which server? | `https://mcp.flung.dev/mcp-oauth` (sign in) or `https://mcp.flung.dev/mcp` (API key). |

## Arguments

| Argument | Type | Required | Description |
|---|---|---|---|
| `q` | `string` | no | Words in the name or folder. at least 1 character; at most 100 characters. |
| `cursor` | `string` | no | nextCursor of the page before. at most 400 characters. |

## Example call

```json
{
  "name": "list_plotwork_diagrams",
  "arguments": {
    "q": "checkout"
  }
}
```

## Things a person might say

- "Which Plotwork diagrams do we have about checkout?"

## Annotations

| Hint | Value |
|---|---|
| `readOnlyHint` | true |
| `destructiveHint` | false |
| `idempotentHint` | true |
| `openWorldHint` | true |

## See also

| Doc | Why |
|---|---|
| [MCP tools](https://docs.flung.dev/mcp/tools.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`GET /v1/plotwork/diagrams`](https://docs.flung.dev/reference/api/get-v1-plotwork-diagrams.md) | The same operation over HTTP |