describe_diagram
Turn a plain-English description into Mermaid diagram source. Describe the flow, system, schema or timeline you want ("a login flow with an OAuth branch and a failure path") and get back complete, valid Mermaid - no need to know the syntax. The mermaid field of the response is directly usable as the mermaid_source input of convert_diagram, so describe -> render is a two-call pipeline. Generation runs on our infrastructure via AWS Bedrock; your description is not sent to any third-party service beyond that.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"description": "<description>"
},
"name": "describe_diagram"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | What the diagram should show, in plain language. Include the nodes/steps/entities you care about; the generator fills in sensible structure. | |
| diagram_type | No | Force a specific Mermaid diagram type. Default "auto" - the generator picks the type that fits the description. |