{ "tools": [ { "name": "list_fonts", "description": "List the designer-visible font files available to Epic CLI's compile and imposition modes (heatapplied's curated set, not the whole store), with catalog_revision, per-font export metadata and the visibility list's provenance.", "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "run_epic", "description": "Execute any Epic CLI mode and return stdout, stderr, and every newly produced file (inline base64 by default, or retained artifact references with artifact_delivery \"reference\").", "inputSchema": { "type": "object", "properties": { "args": { "type": "array", "items": { "type": "string" }, "description": "Epic CLI arguments after `java -jar`; use job-local filenames only" }, "files": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "Job-local filename, for example art.pdf or request.json" }, "base64": { "type": "string", "description": "Base64-encoded file bytes" } }, "required": [ "name", "base64" ] }, "description": "Input PDFs, images, ZIPs, XML, or JSON instruction files", "default": [] }, "expected_outputs": { "type": "array", "items": { "type": "string" }, "description": "Output filenames that must exist for success", "default": [] }, "artifact_delivery": { "type": "string", "enum": [ "inline", "reference" ], "default": "inline", "description": "inline: outputs returned as base64 in artifacts (default). reference: outputs retained server-side and returned as artifact_refs; fetch with get_artifacts." } }, "required": [ "args" ] }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "export_fonts", "description": "Export exact installed TrueType files selected from list_fonts as retained artifacts (font/ttf) plus a JSON manifest. Atomic: either every requested font is exported or none is. Fetch bytes with get_artifacts.", "inputSchema": { "type": "object", "additionalProperties": false, "required": [ "fonts" ], "properties": { "fonts": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "minLength": 1 }, "description": "Exact filenames from list_fonts, including extension and case" }, "catalog_revision": { "type": "string", "minLength": 1, "description": "Optional catalog_revision from list_fonts; a stale value is rejected instead of exporting a changed binary" } } }, "outputSchema": { "type": "object", "required": [ "schema_version", "ok", "request_id", "warnings", "error", "catalog_revision", "fonts", "artifacts", "manifest_artifact_id" ], "properties": { "schema_version": { "type": "integer", "const": 1 }, "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "error": { "oneOf": [ { "type": "object", "required": [ "code", "message", "retryable", "next_action" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "next_action": { "type": "string" }, "details": { "type": "object" } }, "additionalProperties": false }, { "type": "null" } ] }, "catalog_revision": { "type": [ "string", "null" ] }, "fonts": { "type": "array", "items": { "type": "object", "required": [ "filename", "family", "style", "format", "export_status", "policy_reference", "artifact_id" ], "properties": { "filename": { "type": "string" }, "family": { "type": "string" }, "style": { "type": "string" }, "format": { "type": "string", "enum": [ "ttf" ] }, "export_status": { "type": "string", "enum": [ "allowed" ] }, "policy_reference": { "type": "string" }, "artifact_id": { "type": "string" } }, "additionalProperties": false } }, "artifacts": { "type": "array", "items": { "type": "object", "required": [ "artifact_id", "name", "mime_type", "size_bytes", "sha256", "expires_at" ], "properties": { "artifact_id": { "type": "string" }, "name": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "expires_at": { "type": "string", "format": "date-time" } }, "additionalProperties": false } }, "manifest_artifact_id": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "get_epic_capabilities", "description": "Versioned statement of what the deployed Epic engine and this connector support (compile, native Illustrator text limits, artifact delivery, limits). Read from the deployed engine, not assumed. Cache per capability_revision.", "inputSchema": { "type": "object", "additionalProperties": false, "properties": {} }, "outputSchema": { "type": "object", "required": [ "schema_version", "ok", "request_id", "warnings", "error" ], "properties": { "schema_version": { "type": "integer", "const": 1 }, "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "error": { "oneOf": [ { "type": "object", "required": [ "code", "message", "retryable", "next_action" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "next_action": { "type": "string" }, "details": { "type": "object" } }, "additionalProperties": false }, { "type": "null" } ] }, "connector_version": { "type": "string" }, "engine_version": { "type": "string" }, "capability_revision": { "type": "string" }, "catalog_revision": { "type": "string" }, "tools": { "type": "array", "items": { "type": "string" } }, "fonts": { "type": "object", "required": [ "export_tool", "exact_binary_export", "visibility" ], "properties": { "export_tool": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "exact_binary_export": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "visibility": { "type": "object", "required": [ "filter", "source", "origin", "visibility_revision", "visible", "synced_at", "stale", "missing" ], "properties": { "filter": { "type": "boolean", "description": "true: only heatapplied-visible fonts are listed; false: no list readable, whole store served (degraded)" }, "source": { "type": "string", "enum": [ "heatapplied" ] }, "origin": { "type": [ "string", "null" ], "enum": [ "mirror", "seed", null ], "description": "mirror: daily SyncFontList pull; seed: committed snapshot" }, "visibility_revision": { "type": [ "string", "null" ] }, "visible": { "type": "integer", "minimum": 0, "description": "Fonts on the visible list (fonts[] may be fewer if some are missing from the store)" }, "synced_at": { "type": [ "string", "null" ] }, "stale": { "type": "boolean" }, "missing": { "type": "array", "items": { "type": "string" }, "description": "Visible names with no file on this box" } }, "additionalProperties": false } }, "additionalProperties": false }, "compile": { "type": "object", "required": [ "available", "request_schema_versions", "unwarped_pdf_live_text", "warped_pdf_text", "lab_mapping", "native_ai" ], "properties": { "available": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "request_schema_versions": { "type": "array", "items": { "type": "integer" } }, "unwarped_pdf_live_text": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "warped_pdf_text": { "type": "string", "enum": [ "outlined", "live", "unsupported", "unknown" ] }, "lab_mapping": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "native_ai": { "type": "object", "required": [ "status", "experimental", "default_on", "allowed_fonts", "any_font", "layer_types", "warp_styles", "bend_min", "bend_max", "max_warped_layers", "unlimited_warped_layers", "max_spot_colors", "unlimited_spot_colors", "stroke", "rotation", "shear", "flip", "unsupported_handling" ], "properties": { "status": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "experimental": { "type": "boolean" }, "default_on": { "type": [ "boolean", "null" ], "description": "true: private data is authored unless the request sets ai_private:false" }, "allowed_fonts": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "Explicit allow-list; null when unrestricted (see any_font) or unknown" }, "any_font": { "type": "boolean", "description": "true: any catalog TTF face can be authored as native text" }, "layer_types": { "type": "array", "items": { "type": "string" } }, "warp_styles": { "type": "array", "items": { "type": "string" } }, "bend_min": { "type": [ "number", "null" ] }, "bend_max": { "type": [ "number", "null" ] }, "max_warped_layers": { "type": [ "integer", "null" ], "minimum": 0 }, "unlimited_warped_layers": { "type": "boolean" }, "max_spot_colors": { "type": [ "integer", "null" ], "minimum": 0 }, "unlimited_spot_colors": { "type": "boolean" }, "stroke": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "rotation": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "shear": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "flip": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "unsupported_handling": { "type": "string", "enum": [ "soft_degrade_with_warning", "hard_error", "unknown" ], "description": "What happens when a design uses an unsupported feature with ai_private left at its default" } }, "additionalProperties": false } }, "additionalProperties": false }, "artifacts": { "type": "object", "required": [ "retention_seconds", "resource_delivery", "base64_delivery", "max_base64_bytes" ], "properties": { "retention_seconds": { "type": "integer", "minimum": 0 }, "resource_delivery": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "base64_delivery": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "max_base64_bytes": { "type": "integer", "minimum": 0 } }, "additionalProperties": false }, "packaging": { "type": "object", "required": [ "zip_only_intake" ], "properties": { "zip_only_intake": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] } }, "additionalProperties": false }, "manual": { "type": "object", "required": [ "tool", "manual_revision", "chapters", "companions" ], "properties": { "tool": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "manual_revision": { "type": [ "string", "null" ] }, "chapters": { "type": "integer", "minimum": 0 }, "companions": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "pantone": { "type": "object", "required": [ "tool", "pantone_revision", "colors", "synced_at", "stale", "source" ], "properties": { "tool": { "type": "string", "enum": [ "supported", "unsupported", "unknown" ] }, "pantone_revision": { "type": [ "string", "null" ] }, "colors": { "type": "integer", "minimum": 0 }, "synced_at": { "type": [ "string", "null" ] }, "stale": { "type": "boolean" }, "source": { "type": "string" } }, "additionalProperties": false }, "limits": { "type": "object", "required": [ "max_fonts_per_export", "max_artifacts_per_get" ], "properties": { "max_fonts_per_export": { "type": "integer", "minimum": 0 }, "max_artifacts_per_get": { "type": "integer", "minimum": 0 } }, "additionalProperties": false }, "provenance": { "type": "object", "required": [ "source", "observed_at" ], "properties": { "source": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" } }, "additionalProperties": false } }, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "get_artifacts", "description": "Retrieve retained artifacts from export_fonts or run_epic by artifact_id without re-running anything. delivery \"resource\" returns epic-artifact:// resource links (read via resources/read); \"base64\" returns bytes inline up to the published aggregate limit. Atomic.", "inputSchema": { "type": "object", "additionalProperties": false, "required": [ "artifact_ids" ], "properties": { "artifact_ids": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "delivery": { "type": "string", "enum": [ "resource", "base64" ], "default": "resource" } } }, "outputSchema": { "type": "object", "required": [ "schema_version", "ok", "request_id", "warnings", "error", "artifacts" ], "properties": { "schema_version": { "type": "integer", "const": 1 }, "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "error": { "oneOf": [ { "type": "object", "required": [ "code", "message", "retryable", "next_action" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "next_action": { "type": "string" }, "details": { "type": "object" } }, "additionalProperties": false }, { "type": "null" } ] }, "artifacts": { "type": "array", "items": { "oneOf": [ { "type": "object", "required": [ "artifact_id", "name", "mime_type", "size_bytes", "sha256", "expires_at", "delivery", "resource_uri" ], "properties": { "artifact_id": { "type": "string" }, "name": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "expires_at": { "type": "string", "format": "date-time" }, "delivery": { "type": "string", "enum": [ "resource" ] }, "resource_uri": { "type": "string" } }, "additionalProperties": false }, { "type": "object", "required": [ "artifact_id", "name", "mime_type", "size_bytes", "sha256", "expires_at", "delivery", "base64" ], "properties": { "artifact_id": { "type": "string" }, "name": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "expires_at": { "type": "string", "format": "date-time" }, "delivery": { "type": "string", "enum": [ "base64" ] }, "base64": { "type": "string" } }, "additionalProperties": false } ] } } }, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "get_epic_manual", "description": "Explore the Epic CLI manual (the complete reference for every mode, JSON contract and landmine of the deployed jar). No arguments: the chapter index plus companions (\"mcp\" = one-page MCP cheat sheet for the imagegen→print path, \"agent-guide\" = condensed field manual). chapter: one document verbatim (by number, slug or name, e.g. \"7\", \"07-compile\", \"compile\", \"mcp\"; \"index\" for the table). section: only that heading of the chapter. query: full-text search across everything returning ranked sections with snippets. All documents are also readable as epic-manual:// resources.", "inputSchema": { "type": "object", "additionalProperties": false, "properties": { "chapter": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Chapter number, slug or name from the index; \"index\" for the chapter table" }, "section": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Heading within the chapter (case-insensitive; numbering prefix optional). Requires chapter." }, "query": { "type": "string", "minLength": 2, "maxLength": 200, "description": "Search terms; every term must appear in a section for it to match" }, "max_results": { "type": "integer", "minimum": 1, "maximum": 20, "default": 8, "description": "Search result cap" } } }, "outputSchema": { "type": "object", "required": [ "schema_version", "ok", "request_id", "warnings", "error", "manual_revision", "mode", "chapters", "companions", "chapter", "matches" ], "properties": { "schema_version": { "type": "integer", "const": 1 }, "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "error": { "oneOf": [ { "type": "object", "required": [ "code", "message", "retryable", "next_action" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "next_action": { "type": "string" }, "details": { "type": "object" } }, "additionalProperties": false }, { "type": "null" } ] }, "manual_revision": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "index", "chapter", "search" ] }, "chapters": { "type": "array", "items": { "type": "object", "required": [ "id", "slug", "title", "summary", "uri", "size_bytes" ], "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "uri": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 } }, "additionalProperties": false } }, "companions": { "type": "array", "items": { "type": "object", "required": [ "id", "slug", "title", "summary", "uri", "size_bytes" ], "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "uri": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 0 } }, "additionalProperties": false }, "description": "Root-level companion documents: \"mcp\" cheat sheet, \"agent-guide\"" }, "chapter": { "type": [ "object", "null" ], "required": [ "id", "slug", "title", "uri", "section", "headings", "content" ], "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "uri": { "type": "string" }, "section": { "type": [ "string", "null" ] }, "headings": { "type": "array", "items": { "type": "object", "required": [ "level", "text" ], "properties": { "level": { "type": "integer" }, "text": { "type": "string" } }, "additionalProperties": false } }, "content": { "type": "string", "description": "Markdown, verbatim from the manual" } }, "additionalProperties": false }, "matches": { "type": "array", "items": { "type": "object", "required": [ "chapter_id", "slug", "title", "heading", "uri", "score", "snippet" ], "properties": { "chapter_id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "heading": { "type": [ "string", "null" ] }, "uri": { "type": "string" }, "score": { "type": "integer" }, "snippet": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] }, { "name": "list_pantone_colors", "description": "List or look up Pantone spot colours (PMS code, hex, RGB, CMYK, special/semi-opaque flags) from the heatapplied colour catalogue mirrored on this server. No arguments: the whole catalogue, paged (offset/limit). pms: exact lookups by code, e.g. [\"185 C\", \"Cool Gray 9 C\"]; unknown codes are listed in missing, never guessed. query: case-insensitive substring of the code or name (codes starting with it rank first), or a \"#RRGGBB\" hex for an exact hex match. is_special / is_semiopaque narrow the result. pantone_revision changes whenever the catalogue does; synced_at says how fresh the mirror is.", "inputSchema": { "type": "object", "additionalProperties": false, "properties": { "pms": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 60 }, "minItems": 1, "maxItems": 500, "description": "Exact PMS codes to look up (\"185 C\"; a leading \"PANTONE\" is ignored). Cannot be combined with query/offset." }, "query": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Substring of the PMS code or name, or \"#RRGGBB\" for an exact hex match" }, "is_special": { "type": "boolean", "description": "Only specialty inks (metallic, glitter) when true; only regular inks when false" }, "is_semiopaque": { "type": "boolean", "description": "Only semi-opaque inks (need an underbase on darks) when true; only opaque when false" }, "offset": { "type": "integer", "minimum": 0, "default": 0, "description": "Paging start (see next_offset)" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 100, "description": "Page size" } } }, "outputSchema": { "type": "object", "required": [ "schema_version", "ok", "request_id", "warnings", "error", "pantone_revision", "source_revision", "source_updated_at", "synced_at", "stale", "total", "offset", "limit", "count", "next_offset", "colors", "missing" ], "properties": { "schema_version": { "type": "integer", "const": 1 }, "ok": { "type": "boolean" }, "request_id": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "error": { "oneOf": [ { "type": "object", "required": [ "code", "message", "retryable", "next_action" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "next_action": { "type": "string" }, "details": { "type": "object" } }, "additionalProperties": false }, { "type": "null" } ] }, "pantone_revision": { "type": [ "string", "null" ], "description": "Changes whenever the catalogue changes; cache by it" }, "source_revision": { "type": [ "string", "null" ], "description": "heatapplied catalogue fingerprint" }, "source_updated_at": { "type": [ "string", "null" ] }, "synced_at": { "type": [ "string", "null" ], "description": "When the mirror was last confirmed against heatapplied" }, "stale": { "type": "boolean", "description": "True when the mirror has not been confirmed for over 48 hours" }, "total": { "type": "integer", "minimum": 0, "description": "Matches before paging" }, "offset": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 0 }, "count": { "type": "integer", "minimum": 0, "description": "Colours in this page" }, "next_offset": { "type": [ "integer", "null" ], "minimum": 0 }, "colors": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "pms", "hex", "rgb", "cmyk", "is_special", "is_semiopaque", "updated_at" ], "properties": { "id": { "type": "integer", "description": "heatapplied colour id, accepted by its pricing/order APIs as color_ids" }, "name": { "type": "string", "description": "Optional friendly name; empty for plain library rows" }, "pms": { "type": "string", "description": "Pantone code, e.g. \"185 C\"" }, "hex": { "type": [ "string", "null" ], "pattern": "^#[0-9A-Fa-f]{6}$" }, "rgb": { "type": [ "object", "null" ], "required": [ "r", "g", "b" ], "properties": { "r": { "type": "number", "minimum": 0, "maximum": 255 }, "g": { "type": "number", "minimum": 0, "maximum": 255 }, "b": { "type": "number", "minimum": 0, "maximum": 255 } }, "additionalProperties": false }, "cmyk": { "type": [ "object", "null" ], "required": [ "c", "m", "y", "k" ], "properties": { "c": { "type": "number", "minimum": 0, "maximum": 100 }, "m": { "type": "number", "minimum": 0, "maximum": 100 }, "y": { "type": "number", "minimum": 0, "maximum": 100 }, "k": { "type": "number", "minimum": 0, "maximum": 100 } }, "additionalProperties": false }, "is_special": { "type": "boolean", "description": "Specialty ink (metallic, glitter)" }, "is_semiopaque": { "type": "boolean", "description": "Needs an underbase on dark substrates" }, "updated_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true } }, "missing": { "type": "array", "items": { "type": "string" }, "description": "Requested pms codes not in the catalogue" } }, "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }, "securitySchemes": [ { "type": "oauth2", "scopes": [ "mcp" ] } ] } ] }