Skip to main content
Glama

Create text overlay

create_text_overlay

Composite styled text over a visual or on a transparent background for lyrics, titles, or credits. Configure font size, color, alignment, and resolution.

Instructions

Composite styled text over a visual (or on its own transparent background) — a Text TOP with font size, color, and alignment, optionally laid 'over' a source TOP through a Composite TOP, output as a Null. For lyrics, titles, song names, or credits in a set. Distinct from the vault's bind_vault_text (which data-syncs a Text DAT to a note); this is a finished visual layer ready for setup_output.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
textNoThe text to display.TEXT
source_pathNoOptional TOP to composite the text over (e.g. a finished visual). Omit to get the text alone on a transparent background, ready to composite later.
font_sizeNoFont size in pixels.
colorNoText color as a hex string, e.g. '#ff3366'.#ffffff
alignNoHorizontal alignment.center
valignNoVertical alignment.center
resolutionNoOutput resolution of the Text TOP: '720p' (1280×720), '1080p' (1920×1080), or '4K' (3840×2160).1080p
parent_pathNoParent COMP path the self-contained 'text_overlay' container is created inside./project1
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Describes internal composition (Text TOP, Composite TOP) and output as Null. Annotations indicate non-destructive write operation; no contradiction. Adds behavioral context beyond annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences, front-loaded with purpose and usage guidance. Every sentence adds value without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, use cases, internal structure, and output. With 8 parameters all well-described in schema, description is sufficient. No output schema needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. Description does not add significant extra meaning to parameters beyond what schema provides; no contradiction or omission.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description explicitly states it composites styled text over a visual or on transparent background, and distinguishes from sibling bind_vault_text. Verb 'create' and resource 'text overlay' are clear.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides specific use cases (lyrics, titles, song names, credits) and clearly distinguishes from sibling tool bind_vault_text. Lacks explicit when-not-to-use or alternative scenarios, but context is strong.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Pantani/tdmcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server