MCP Server

The Figviz MCP server lets any Model Context Protocol client — Claude Desktop, Cursor, Cline, Windsurf, and more — generate labeled science and math diagrams through the Figviz API. Published on npm as @figviz/figviz-mcp.

What it exposes

A single tool, generate_diagram: describe a diagram in plain text and get back a hosted image URL. Options are quality (1k / 2k / 4k) and aspectRatio (e.g. 16:9, 1:1).

Example prompts to try from your assistant:

• "labeled plant cell cross-section for 8th grade"
• "convex lens ray diagram, object between F and 2F"
• "acid–base titration setup for high school chemistry"
• "KWL chart graphic organizer, blank"

Get an API key

Create a key (new accounts include 8 free credits) at Settings > API. The MCP server draws from the same pay-as-you-go balance as your Figviz account.

Run it

No install needed — npx fetches and runs it:

FIGVIZ_API_KEY=fvk_xxx npx -y @figviz/figviz-mcp

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "figviz": {
      "command": "npx",
      "args": ["-y", "@figviz/figviz-mcp"],
      "env": { "FIGVIZ_API_KEY": "fvk_xxx" }
    }
  }
}

Cursor / Cline / Windsurf

Add the same server entry to your client's MCP config (mcp.json or the MCP settings UI):

{
  "mcpServers": {
    "figviz": {
      "command": "npx",
      "args": ["-y", "@figviz/figviz-mcp"],
      "env": { "FIGVIZ_API_KEY": "fvk_xxx" }
    }
  }
}

Then ask your assistant: "Use figviz to generate a labeled animal cell diagram for 7th grade."

Environment variables

Credits & pricing

Each diagram costs 1 credit (4k costs 2). Buy credit packs at /pricing. Prefer to call the API from your own code instead? See the JavaScript SDK or the REST API reference.