image_watermark
imagepeek: Add a text watermark to an image. For PDFs use pdf_watermark. Returns the image with a text watermark (1-200 printable characters, DejaVu Sans Mono) at one of 9 positions, or tiled in a staggered grid, with opacity, font_size (default 5% of the short side), color, angle and margin; tex...
This record as markdown: /tools/dev-tanod-tanod/image-watermark.md
What image_watermark does on Tanod
AI agents use image_watermark to create or update resources in Tanod, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Tanod environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | object | — | Public http(s) URL of the image (at most 10 MB; private, internal and IP-literal hosts are refused); or use image_base64. |
text | string | Yes | 1-200 printable characters. |
tile | boolean | — | A staggered grid (at most 2,500 marks). |
angle | number | — | Text rotation in degrees, clockwise (-180 to 180, default 0). |
color | string | — | Text colour as #rrggbb or #rrggbbaa (default #ffffff). |
format | object | — | Output format (default: the input's; ICO in, PNG out). |
margin | object | — | Pixels from the edge (default half the font size, at least 4); with tile, the gap between marks. |
output | string | — | base64 (default): inline. url: stored for 24 hours; link, metadata. |
opacity | number | — | 0 (invisible) to 1 (opaque); default 0.5. |
quality | object | — | Encoder quality 1-100 (lossy formats). |
position | string | — | Single mark's place: center, top, bottom, left, right, top-left, top-right, bottom-left or bottom-right (default). |
font_size | object | — | Default: 5% of the short side. |
Parameters from the server's own tool schema.
Why image_watermark is rated Medium
An AI agent can call image_watermark faster than any human can review: one bad instruction and it creates or modifies resources in Tanod by the hundred, each call as confident as the last.
Risk signalsAccepts URL/endpoint input (url) · High parameter count (14 properties)
Attacks that exploit this kind of access
The rule that runs image_watermark safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Tanod, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For image_watermark, this is the rule to start with:
image_watermark stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Tanod, apply this rule, and every image_watermark call is checked against it from then on.
Questions about image_watermark
imagepeek: Add a text watermark to an image. For PDFs use pdf_watermark. Returns the image with a text watermark (1-200 printable characters, DejaVu Sans Mono) at one of 9 positions, or tiled in a staggered grid, with opacity, font_size (default 5% of the short side), color, angle and margin; text larger than the image is shrunk to fit. Reads PNG, JPEG, WebP, GIF, TIFF, BMP, ICO and AVIF; other formats and images over 40 megapixels are refused (not charged). Output: base64 data_base64, without EXIF, GPS, XMP or IPTC; over 15 MB or 50 megapixels is a 413 (not charged). Images are not logged; a result is kept only with output "url" (24 h). Typically 0.5-2 s. Price: USD 0.002. Free: 3 imagepeek calls per IP per UTC day. Docs: https://tanod.dev/learn/image-watermark-api.html. It is categorised as a Write tool in the Tanod MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
image_watermark accepts 12 parameters: url, text, tile, angle, color, format, margin, output, opacity, quality, position, font_size. Required: text. The full parameter table on this page comes from the server's own tool schema.
Register the Tanod MCP server in PolicyLayer and add a rule for image_watermark: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Tanod. Nothing to install.
image_watermark is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the image_watermark rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for image_watermark. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
image_watermark is provided by the Tanod MCP server (https://tanod.dev/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Tanod, and thousands of servers like it.
This server
Across the catalogue