Skip to main content
Glama

StackFast FractWin Expert Brain

by io.github.Trupe-Rs

Create CogentCast Package

cogentcast_package_create
Read-onlyIdempotent

Create one governed Work Sample from a tenant-bound preview reference, preserve the private narration-review create contract, or append a zero-cost audiobook preparation record through CHIEF_EDITOR_REVIEW. No create path can mint a human pass or make a vendor call. Audiobook Production v1 reuses this five-tool surface: content_type=audiobook_production registers exact manuscript/script/SSML plus provenance, pronunciation, visual/companion, and deterministic-build receipts at zero cost; production.status returns the current derivative and Chief Editor/Gemini/ear/paid/publication gates. Paid canary, full generation, and publication are distinct receipt-gated stages. Uses the existing CogentCast production service; it does not bypass Studio, mint Chief Editor/Robert approval, substitute model output for human authority, publish publicly, or expose credentials.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
inputNoCogentCast Work Sample, private narration review, or zero-cost governed audiobook preparation input. The selected mode is validated by the production service before state or vendor cost is created.
source_hashesNo
preview_digestYes
idempotency_keyNoCaller-stable key for this single create operation. Exact replays return the stored result; a different key is rejected.
preview_referenceNoOpaque short-lived reference returned by package.preview.
content_fingerprintNoExact immutable metadata/source fingerprint returned by package.preview.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
errorNo
resultNo
gateway_receiptYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed11 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / content_fingerprint
      Added value: +{
+  "description": "Exact immutable metadata/source fingerprint returned by package.preview.",
+  "pattern": "^[a-fA-F0-9]{64}$",
+  "type": "string"
+}
    • addedInput schema / properties / idempotency_key
      Added value: +{
+  "description": "Caller-stable key for this single create operation. Exact replays return the stored result; a different key is rejected.",
+  "maxLength": 200,
+  "minLength": 12,
+  "type": "string"
+}
    • addedInput schema / properties / input / additionalProperties
      Added value: +true
    • addedInput schema / properties / input / description
      Added value: +"CogentCast Work Sample, private narration review, or zero-cost governed audiobook preparation input. The selected mode is validated by the production service before state or vendor cost is created."
    • addedInput schema / properties / input / properties
      Added value: +{
+  "article_state": {
+    "enum": [
+      "planned"
+    ],
+    "type": "string"
+  },
+  "article_url": {
+    "format": "uri",
+    "type": "string"
+  },
+  "audience": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "avatar_profile": {
+    "type": "string"
+  },
+  "content_type": {
+    "enum": [
+      "work_sample",
+      "narration_review",
+      "audiobook_production"
+    ],
+    "type": "string"
+  },
+  "cta_url": {
+    "description": "Optional for private author review. When present, HTTPS with a non-root path is required. Metadata only; never spoken.",
+    "format": "uri",
+    "type": "string"
+  },
+  "deck": {
+    "additionalProperties": false,
+    "description": "A real Office Open XML .pptx container. Deck text is visual input and is never spoken.",
+    "properties": {
+      "content_base64": {
+        "description": "RFC 4648 base64 of the raw file bytes; do not base64-encode an existing .b64 text file.",
+        "minLength": 4,
+        "type": "string"
+      },
+      "file_size": {
+        "description": "Decoded byte length. It must equal the raw file size.",
+        "maximum": 10000000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "filename": {
+        "description": "Original filename, including .md for narration or .pptx for the deck.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mime_type": {
+        "description": "IANA media type matching the supplied file.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "sha256": {
+        "description": "SHA-256 of the decoded raw file bytes.",
+        "pattern": "^[a-fA-F0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "description": "Caller-controlled immutable source version label.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mime_type",
+      "content_base64",
+      "file_size",
+      "sha256",
+      "version"
+    ],
+    "type": "object"
+  },
+  "disclosure": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "format": {
+    "enum": [
+      "16:9",
+      "9:16"
+    ],
+    "type": "string"
+  },
+  "historical_derivatives": {
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "idempotency_key": {
+    "type": "string"
+  },
+  "intended_visibility": {
+    "enum": [
+      "private",
+      "unlisted"
+    ],
+    "type": "string"
+  },
+  "internal_links": {
+    "items": {
+      "format": "uri",
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "lineage_id": {
+    "type": "string"
+  },
+  "pacing_profile": {
+    "minLength": 1,
+    "type": "string"
+  },
+  "preparation": {
+    "additionalProperties": true,
+    "description": "Exact source/script/SSML and preparation artifact hashes plus 100% provenance, zero unresolved pronunciation, complete visual classification, deterministic regeneration, and governance-test counts.",
+    "type": "object"
+  },
+  "publication_authority": {
+    "const": false,
+    "type": "boolean"
+  },
+  "script": {
+    "additionalProperties": false,
+    "description": "Canonical Markdown narration source. Markdown syntax, front matter, hidden notes, production notes, URLs, and metadata are never spoken.",
+    "properties": {
+      "content_base64": {
+        "description": "RFC 4648 base64 of the raw file bytes; do not base64-encode an existing .b64 text file.",
+        "minLength": 4,
+        "type": "string"
+      },
+      "file_size": {
+        "description": "Decoded byte length. It must equal the raw file size.",
+        "maximum": 10000000,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "filename": {
+        "description": "Original filename, including .md for narration or .pptx for the deck.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mime_type": {
+        "description": "IANA media type matching the supplied file.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "sha256": {
+        "description": "SHA-256 of the decoded raw file bytes.",
+        "pattern": "^[a-fA-F0-9]{64}$",
+        "type": "string"
+      },
+      "version": {
+        "description": "Caller-controlled immutable source version label.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "filename",
+      "mime_type",
+      "content_base64",
+      "file_size",
+      "sha256",
+      "version"
+    ],
+    "type": "object"
+  },
+  "title": {
+    "type": "string"
+  },
+  "topic_image": {
+    "format": "uri",
+    "type": "string"
+  },
+  "voice_profile": {
+    "minLength": 1,
+    "type": "string"
+  }
+}
    • addedInput schema / properties / input / required
      Added value: +[
+  "content_type"
+]
    • addedInput schema / properties / preview_digest / pattern
      Added value: +"^[a-fA-F0-9]{64}$"
    • addedInput schema / properties / preview_reference
      Added value: +{
+  "description": "Opaque short-lived reference returned by package.preview.",
+  "pattern": "^sfccpr_[A-Za-z0-9]{24,64}$",
+  "type": "string"
+}
    • addedInput schema / properties / source_hashes
      Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "deck": {
+      "pattern": "^[a-fA-F0-9]{64}$",
+      "type": "string"
+    },
+    "script": {
+      "pattern": "^[a-fA-F0-9]{64}$",
+      "type": "string"
+    }
+  },
+  "required": [
+    "script",
+    "deck"
+  ],
+  "type": "object"
+}
    • changedInput schema / required
      Previous value: -[
-  "input",
-  "preview_digest"
-]New value: +[
+  "preview_digest"
+]
  2. Changed3 schema fields changed
    • addedOutput schema / oneOf
      Added value: +[
+  {
+    "required": [
+      "result"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]
    • addedOutput schema / properties / error
      Added value: +{
+  "type": "string"
+}
    • changedOutput schema / required
      Previous value: -[
-  "ok",
-  "result",
-  "gateway_receipt"
-]New value: +[
+  "ok",
+  "gateway_receipt"
+]
  3. Added

TDQS

B3.3/5.0
Behavior1/5

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

The description says 'Create...', 'append... record', and 'registers... receipts', all implying persistent state changes, while annotations declare readOnlyHint=true. This is a direct contradiction, so the description actively misleads the agent about side effects. The rich caveats about zero cost and no vendor call cannot compensate for this fundamental conflict.

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

Conciseness3/5

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

The opening sentence is front-loaded and dense with purpose, and the later clauses about no vendor call, no human pass, and distinct stages are informative. However, the description is one long block with some redundancy between 'No create path can mint a human pass or make a vendor call' and the later list of what it does not bypass/mint/substitute, so it is not as concise as it could be.

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

Completeness3/5

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

For a complex tool, the description covers a lot: three modes, zero-cost semantics, authority gates, integration with production.status, and explicit exclusions. But the readOnlyHint contradiction makes the overall context unreliable, and it never explicitly states which sibling should handle the paid canary/full generation/publication stages, leaving an important routing gap.

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 description coverage is 67%, and the description does add value by explaining content_type=audiobook_production semantics and referencing a tenant-bound preview reference. However, it does not systematically describe source_hashes, preview_digest, content_fingerprint, or the full input object semantics beyond what the schema already provides; the schema remains the primary source for most parameters.

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?

The opening sentence enumerates three distinct create modes (governed Work Sample, private narration-review contract, zero-cost audiobook preparation) with specific verbs and a resource, and the rest of the description distinguishes this surface from production.status and from paid canary/full generation/publication stages. This is specific enough to tell cogentcast_package_create apart from siblings like cogentcast_production_run and cogentcast_package_preview.

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?

The description gives clear contexts for using the tool: content_type=audiobook_production registers exact receipts at zero cost, and paid canary, full generation, and publication are stated to be distinct receipt-gated stages, implying those belong elsewhere. It also states what no create path can do. However, it never explicitly names the sibling tool to use for paid canary/full generation/publication, so it stops short of full when-versus-alternative guidance.

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

All StackFast FractWin Expert Brain toolsInspect
Try in Browser
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

C2.6/5.0
Disambiguation1/5

Several tools are exact duplicates (talent_scout_my_profile_status and talent_scout_profile_status have identical descriptions), and eight estimator_estimate_* tools share the same generic description with no differentiation. This will cause misselection.

Naming Consistency3/5

Most tools follow a snake_case verb_noun pattern, but there are inconsistencies: the duplicate profile tools have different naming (my_profile vs profile), and `fetch`/`search` are single-word verbs. Predictability is hampered by these deviations.

Tool Count2/5

65 tools is excessive for a coherent set, especially with many tools covering overlapping actions across multiple unrelated domains (AI receptionist, estimator, talent scout, GrowthOS). The count could be trimmed significantly.

Completeness3/5

The tool surface is broad and covers many lifecycle operations (create, read, export, record), but the duplicate tools and identical descriptions for estimator operations make it unclear whether all needed operations are present. Some expected operations like delete/update are missing for certain resources.

Resources