Whimsical MCP Server logo

Whimsical MCP Server

by BrockReece

The Whimsical MCP Server enables programmatic creation of Whimsical diagrams. It integrates with Whimsical's API to generate diagrams from Mermaid markup.

View on GitHub

Last updated: N/A

What is Whimsical MCP Server?

A Model Context Protocol (MCP) server that allows you to create Whimsical diagrams programmatically using Mermaid markup.

How to use Whimsical MCP Server?

Install the server either via Smithery or manually by cloning the repository, installing dependencies, and building the project. Then, update your MCP Client's configuration to point to the server's dist folder.

Key features of Whimsical MCP Server

  • Creates Whimsical diagrams from Mermaid markup

  • Integrates with Whimsical's API

  • Returns diagram URL

  • Returns base64 encoded image

Use cases of Whimsical MCP Server

  • Generating system architecture diagrams

  • Creating flowcharts programmatically

  • Automating diagram creation from code

  • Visualizing data with diagrams

FAQ from Whimsical MCP Server

What is Mermaid markup?

Mermaid is a text-based diagramming tool that uses a simple syntax to define diagrams.

What is an MCP Client?

An MCP Client (e.g., Claude, Windsurf) is a tool that interacts with MCP servers to perform specific tasks, such as generating diagrams.

How do I get a Whimsical API key?

You will need to refer to Whimsical's documentation for information on obtaining an API key.

Can I customize the diagram appearance?

The appearance of the diagram is primarily determined by the Mermaid markup. Refer to the Mermaid documentation for customization options.

What if the diagram generation fails?

Check the server logs for any errors. Ensure that the Mermaid markup is valid and that the Whimsical API is accessible.