# smythmyke/markitup-mcp-server [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/smythmyke/markitup-mcp-server  
**GitHub Stars:** 2  
**npm Downloads (last month):** 198  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/smythmyke-markitup-mcp-server

## Description
AI image annotation and marketing-visual generator powered by MarkItUp. Five tools: generate polished marketing visuals from a screenshot (Claude writes copy → Gemini renders across 50+ templates including glassmorphic, bold marketing, documentation, and app store), regen, AI outpaint, and HD background removal. Install: npx -y markitup-mcp-server.

## Tools
Capabilities this server exposes over MCP:

- **markitup_credit_balance** — Returns the current credit balance and subscription status.
- **markitup_generate** — Generates 3 polished marketing-visual variations from a screenshot. Costs 1 credit.
- **markitup_regen** — Regenerate one variation from a previous `markitup_generate` call. Costs 1 credit by default (`charge_credit: false` to skip).
- **markitup_extend** — AI outpaint — extend an image to a larger canvas / different aspect ratio. Costs 1 credit.
- **markitup_remove_background** — Remove the background from an image via Photoroom's HD model. Returns a transparent PNG. Costs 1 credit (free for active Pro/Power subscribers).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "markitup-mcp-server": {
    "command": "npx",
    "args": ["-y","markitup-mcp-server"],
    "env": {
      "MARKITUP_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `MARKITUP_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/smythmyke-markitup-mcp-server/readme_