Markitup MCP Server

What smythmyke/markitup-mcp-server MCP server does

The smythmyke/markitup-mcp-server MCP server exposes MarkItUp image-generation and image-editing operations through the Model Context Protocol. It is intended for MCP-compatible clients that need to create or prepare marketing visuals from screenshots and other source images.

Five tools are available:

• markitup_credit_balance checks the current credit balance and subscription status.
• markitup_generate creates three marketing-visual variations from a screenshot and returns generated copy, including a headline and sub-headline.
• markitup_regen regenerates one variation from an earlier generation.
• markitup_extend uses AI outpainting to expand an image to a larger canvas or another aspect ratio.
• markitup_remove_background produces a transparent PNG using Photoroom's HD background-removal model.

Generation supports templates such as glassmorphic, clean_minimal, bold_marketing, dark_professional, and documentation, with additional templates also available.

How it works

An MCP client starts the server locally with npx and passes the MarkItUp API key through the environment. The tools then call MarkItUp using either a public HTTPS image URL or base64-encoded image data, depending on the operation.

markitup_generate requires a description and template identifier, plus one source-image input. Optional settings include aspect ratio and output size. Its response contains three image variations as base64 image content blocks, along with the generated marketing text and structured response data.

To use markitup_regen, the client must provide the text_analysis object from the earlier generation response and select a variation index from 0 through 2. This allows the regenerated result to retain the earlier headline and sub-headline. Regeneration normally costs one credit, although charge_credit: false can skip that charge.

The other image operations also consume credits under the conditions documented by MarkItUp. Background removal is free for active Pro and Power subscribers; otherwise, it costs one credit.

Setup and configuration

Install the smythmyke/markitup-mcp-server MCP server through the package runner command npx -y markitup-mcp-server. Node.js 18 or newer is required for local installation, although an MCP client that bundles Node.js may not require a separate local Node.js installation.

A MarkItUp account and API key are required. Set MARKITUP_API_KEY in the MCP client's server configuration. MARKITUP_API_BASE is optional and can replace the default API endpoint, https://markitup.app/api/v1, for testing against another environment.

The README provides configuration examples for Claude Code, Claude Desktop, and Cursor. Keep the API key out of source control. If it is exposed, revoke it from the MarkItUp dashboard and create a replacement.

Tools and capabilities

The generation tool accepts aspect ratios including 1:1, 16:9, 9:16, and 21:9, and image sizes of 1K, 2K, or 4K. The extension tool requires a target aspect ratio and output pixel dimensions. Both generation and image extension accept image URLs or base64 data; base64 inputs can include an image MIME type, with PNG as the default.

The server reports human-readable errors for missing or invalid API keys, depleted credits, and rate limits. The project is released under the MIT license.