Markitup Mcp Server

io.github.smythmykePublished by GitHub account smythmykev0.1.1Updated Oct 24, 2026

MarkItUp AI image annotation and marketing-visual generator (variations, outpaint, bg-removal).

VerifiedSTDIODesktop onlyBusiness & CommerceMedia & Design

Overview

AI-generated overview

MarkItUp MCP server lets an assistant generate marketing visuals from screenshots, regenerate variations, outpaint images and remove backgrounds via the…

What you can do
  • Check the account's credit balance and subscription status
  • Generate three marketing-visual variations from a screenshot with a chosen template, aspect ratio and size, returning copy plus images
  • Regenerate a single variation from a previous generation while keeping the same headline and sub-headline
  • Extend an image to a larger canvas or different aspect ratio (AI outpaint)
  • Remove an image background and return a transparent PNG
When to use it
Useful when you want an assistant to turn product screenshots into marketing or landing-page visuals, produce on-brand variations, reframe images to other aspect ratios, or cut out backgrounds without leaving the chat client.
Requirements
A MarkItUp account and an API key from the MarkItUp dashboard, supplied as the MARKITUP_API_KEY environment variable. Runs locally over stdio, typically via npx, which needs Node.js 18 or newer unless the MCP client bundles one. Network access to the MarkItUp API; MARKITUP_API_BASE can override the endpoint.
Before you install
The API key is a billable credential: keep MARKITUP_API_KEY out of source control and revoke it if exposed. Generation, regeneration, outpaint and background removal each cost 1 credit (background removal is free for active Pro/Power subscribers), so calls spend account credits. Source images are sent to MarkItUp's API, and background removal is handled by Photoroom's model, so avoid submitting sensitive screenshots.

Installation

In SourceWeft

  1. Open Markitup Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

markitup-mcp-server

[npm version] [MCP Registry] [Glama] [smithery badge] [License: MIT]

MCP (Model Context Protocol) server for MarkItUp — AI-powered image annotation and marketing-visual generation. Lets Claude Code, Claude Desktop, Cursor, ChatGPT-with-MCP, and other MCP-compatible clients call MarkItUp directly.

Five tools available: markitup_credit_balance, markitup_generate, markitup_regen, markitup_extend, markitup_remove_background.

Prerequisites

  1. A MarkItUp account — sign up at https://markitup.app.
  2. A MarkItUp API key — generate one at https://markitup.app/dashboard.
  3. Node.js 18 or newer (only if installing locally; npx doesn't require a local Node.js if your MCP client bundles one).

Configure in Claude Code

Add to your MCP config (~/.claude/mcp.json or project-scoped .mcp.json):

jsonc
{  "mcpServers": {    "markitup": {      "command": "npx",      "args": ["-y", "markitup-mcp-server"],      "env": {        "MARKITUP_API_KEY": "mk_live_..."      }    }  }}

Configure in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

jsonc
{  "mcpServers": {    "markitup": {      "command": "npx",      "args": ["-y", "markitup-mcp-server"],      "env": {        "MARKITUP_API_KEY": "mk_live_..."      }    }  }}

Configure in Cursor

Cursor uses the same JSON shape. Settings → MCP → Add Server:

jsonc
{  "mcpServers": {    "markitup": {      "command": "npx",      "args": ["-y", "markitup-mcp-server"],      "env": { "MARKITUP_API_KEY": "mk_live_..." }    }  }}

Tools

markitup_credit_balance

Returns the current credit balance and subscription status.

No arguments. Use it to verify your API key works and to check credits before calling generation tools.

markitup_generate

Generates 3 polished marketing-visual variations from a screenshot. Costs 1 credit.

ArgumentTypeRequiredDescription
descriptionstringyesWhat the image shows and what to highlight
template_idstringyesOne of glassmorphic, clean_minimal, bold_marketing, dark_professional, documentation (and more)
image_urlstringone-ofPublic HTTPS URL of the source image
image_base64stringone-ofBase64-encoded image bytes (no data: prefix)
image_mime_typestringnoMIME type when supplying image_base64. Default: image/png
aspect_ratiostringnoOne of 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
image_sizestringno1K, 2K, or 4K

Returns: the marketing copy (headline, sub-headline) plus 3 generated image variations as base64 image content blocks. The full structured response is also available under structuredContent.

Example prompt (in Claude Code):

Use markitup_generate with the screenshot at https://example.com/dashboard.png — highlight the export button and pitch it for a marketing landing page using the bold_marketing template.

markitup_regen

Regenerate one variation from a previous markitup_generate call. Costs 1 credit by default (charge_credit: false to skip).

The LLM must pass back the text_analysis object from the previous generate's structuredContent.text so the regenerated visual stays on-brand with the same headline / sub-headline. variation_index selects which slot (0–2).

markitup_extend

AI outpaint — extend an image to a larger canvas / different aspect ratio. Costs 1 credit.

ArgumentTypeRequiredDescription
image_url / image_base64stringone-ofSource image
aspect_ratiostringyesTarget ratio (16:9, 9:16, etc.)
target_width / target_heightnumberyesOutput pixel dimensions
image_sizestringno1K, 2K, or 4K

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

ArgumentTypeRequiredDescription
image_url / image_base64stringone-ofSource image

Environment variables

VarRequiredDescription
MARKITUP_API_KEYyesAPI key from your MarkItUp dashboard
MARKITUP_API_BASEnoOverride the API base URL. Default: https://markitup.app/api/v1. Useful for testing against staging.

Local development

bash
git clone https://github.com/markitup/mcp-server.gitcd mcp-servernpm installnpm run build
# Point your MCP client config at the local build:{  "command": "node",  "args": ["/absolute/path/to/mcp-server/dist/index.js"],  "env": { "MARKITUP_API_KEY": "mk_test_..." }}

Security

  • Never commit MARKITUP_API_KEY to source control.
  • If you accidentally expose a key, revoke it immediately at https://markitup.app/dashboard and create a new one.
  • Keys are SHA-256 hashed on the server; the raw key is shown only once at creation.

Errors

The server surfaces clean human-readable errors for the common cases:

  • Invalid or missing MARKITUP_API_KEY — set or rotate the key.
  • Out of MarkItUp credits — top up at https://markitup.app/credits.
  • Rate limit exceeded — wait briefly and retry.

License

MIT

Source: README.md at commit a8d88fd

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts