About markly
markly-mcp-server lets AI agents add text or logo watermarks to images through the Markly.cloud API. It supports single-image processing and batches, with an anonymous tier available and an API key for higher limits and unbranded output.
Key features
- 01Add text watermarks to image URLs
- 02Add logo watermarks to image URLs
- 03Batch watermark up to 20 images
- 04Check API quota and usage
Use cases
- 01Mark images with copyright text
- 02Apply a logo to image assets
- 03Process image batches into a ZIP
MCP support
Exposes Markly.cloud watermarking and usage-check tools to MCP clients. The server can run anonymously or use MARKLY_API_KEY.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y markly-mcp-serverMARKLY_API_KEYSecretYour Markly API key (optional - works without for free tier with branding)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| font | enum | No | Font (default inter)inter | roboto | playfair | courier | arial |
| size | number | No | Font size in pixels (12-200, default 48) |
| text | string | Yes | Watermark text (max 200 characters) |
| tile | boolean | No | Tile the watermark across the entire image (default false) |
| angle | number | No | Rotation angle in degrees (-180 to 180, default -30) |
| color | string | No | Hex color (e.g. #ffffff, default white) |
| opacity | number | No | Opacity percentage (5-100, default 50) |
| position | enum | No | Watermark position (default center)top-left | top | top-right | left | center | right | bottom-left | bottom | bottom-right |
| image_url | string | Yes | URL of the image to watermark (must be publicly accessible) |
Details
From the project READMEmarkly-mcp-server
MCP (Model Context Protocol) server for Markly.cloud - add watermarks to images via AI agents.
Works out of the box without an API key (free tier with branding). Add an API key to remove branding and increase limits.
Tools
| Tool | Description |
|---|---|
markly_watermark_text | Add a text watermark to an image via URL |
markly_watermark_logo | Add a logo watermark to an image via URL |
markly_batch_watermark | Watermark up to 20 images, get a ZIP |
markly_check_usage | Check API quota and usage stats (requires API key) |
Quick start (no API key needed)
Add to your Claude Desktop config or Claude Code settings:
{
"mcpServers": {
"markly": {
"command": "npx",
"args": ["-y", "markly-mcp-server"]
}
}
}
That's it. Ask your AI agent:
"Add 'Copyright 2026' as a watermark to this image: https://example.com/photo.jpg"
With an API key (optional)
Get an API key at markly.cloud/developers to remove the "markly.cloud" branding and get higher rate limits.
{
"mcpServers": {
"markly": {
"command": "npx",
"args": ["-y", "markly-mcp-server"],
"env": {
"MARKLY_API_KEY": "mkly_your_token_here"
}
}
}
}
Environment variables
| Variable | Required | Default |
|---|---|---|
MARKLY_API_KEY | No | - (anonymous free tier) |
MARKLY_API_URL | No | https://www.markly.cloud/api/v1 |
Plans
| Plan | Rate limit | Daily limit | Branded watermark |
|---|---|---|---|
| Anonymous | 5/min | 50/day | Yes ("markly.cloud") |
| Credit | 60/min | 1,000/day | No (while credits last) |
| Pro | 60/min | 1,000/day | No |
| Business | 120/min | 5,000/day | No |
Buy credits at markly.cloud/developers - starting at 250 credits for 5 EUR.
License
MIT
Protected by Copyright01 - Ref: CR-2026-33771 - Certified 2026-03-03
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.