Figranium MCP server

Figranium MCP Server

A Model Context Protocol (MCP) server for Figranium, built with @modelcontextprotocol/sdk and the official @figranium/sdk API client. This server allows LLM clients (like Cline, Claude Desktop, Cursor, and Manus AI) to discover, execute, inspect, schedule, and programmatically create Figranium automation tasks via standard STDIO transport.

Table of Contents

• Quick Start (Docker / OCI)
• Client Integration
• Cline
• Claude Desktop
• Cursor IDE
• Manus AI / Registry Clients
• Automated AI Setup (llms-install.md)
• Environment Variables
• Server-Wide System Instructions
• Available Resources
• Available Tools
• Task Operations

Quick Start (Docker / OCI)

No Node.js runtime or repository clone is required. The official container image is published on GitHub Container Registry (ghcr.io).

Zero-config npm usage is also supported:

npx -y figranium-mcp

For local development:

git clone https://github.com/figranium/figranium-mcp
dcd figranium-mcp
npm install
npm run build

docker pull ghcr.io/figranium/figranium-mcp:latest

Environment Variables

The server requires the following environment variables to interact with your Figranium instance:

• FIGRANIUMBASEURL: The base URL of your Figranium server. Defaults to http://localhost:11345.
• FIGRANIUMAPIKEY: The API key generated from Figranium settings to authorize requests. This variable is required for startup.

If FIGRANIUMAPIKEY is missing, the server prints a clear setup message and exits gracefully.

Client Integration

Cline

Add the following to your clinemcpsettings.json:

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/clinemcpsettings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\clinemcpsettings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/clinemcpsettings.json

{
  "mcpServers": {
    "figranium": {
      "command": "npx",
      "args": ["-y", "figranium-mcp"],
      "env": {
        "FIGRANIUM_BASE_URL": "http://localhost:11345",
        "FIGRANIUM_API_KEY": "your_figranium_api_key_here"
      }
    }
  }
}

Alternatively, if running directly from a cloned source repository:

{
  "mcpServers": {
    "figranium": {
      "command": "node",
      "args": ["/path/to/figranium-mcp/dist/index.js"],
      "env": {
        "FIGRANIUM_BASE_URL": "http://localhost:11345",
        "FIGRANIUM_API_KEY": "your_figranium_api_key_here"
      }
    }
  }
}

Automated Setup for Cline: Give Cline a link or reference to llms-install.md and Cline will perform the setup and configuration automatically.

Claude Desktop

Add the container configuration to your claudedesktopconfig.json:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

Shortened. The full README is on GitHub.