Narracore Screenplay Formatter

Format screenplay (blocks + PDF)

format_screenplay

Convert raw or loosely formatted screenplay text (Chinese, English, or mixed — including Japanese broadcast-drama format and Chinese colon-style dialogue scripts) into professionally structured screenplay blocks and a print-ready PDF on a fixed typewriter character grid identical to narracore.cn. Use it for screenplay formatting, import, or producing a shareable screenplay PDF — NOT for general prose rewriting or story editing.

INPUT (contract_version 3) — two modes: • input_format="text" (default): line-based screenplay text, one element per line — scene headings ("INT. LAB - DAY", "第 N 场 …"), CHARACTER names in CAPS or CJK on their own line, short dialogue lines after them, standalone (…) parentheticals, standalone transitions ("CUT TO:", "切至：…"). Inline dialogue 名前「セリフ」 and 人名：台词 is parsed natively. An unbroken wall of text renders as continuous action and is flagged UNRESOLVED_STRUCTURE. • input_format="blocks": typed blocks validated and rendered EXACTLY as submitted, never re-classified; ids echoed. CHAINING: to run other tools on this screenplay, pass back the BLOCKS you received — not the plain text (it parses differently). The same screenplay is charged once per 24h across analyze/diagnose/convert/video-prompt tools; check_video_prompts is free. • output="validate_only": structure check + diagnostics only, free.

Before delivering: read diagnostics[] (code/severity/line or block_id/message/suggested_action) with the user; confidence = share of non-ambiguous lines, NOT accuracy.

Billing: one credit = one screenplay for 24h across the screenplay tools (or one film analysis / one story project). Free tier: one credit per day per visitor, no key. Failed calls are never charged; the same request_id never double-charges. On free_tier_exhausted or quota_exhausted: relay the price and purchase link from the response verbatim; never invent a license key.

Competition submissions: style="uk"/"fr" (A4, BBC/French layout), dialogue_breaks=true ((MORE)/(CONT'D) on page breaks), cover.anonymous=true (no author on title page) — rendering options, free within the 24h bundle.

Full parameter manual (cover/header/footer/style, examples): https://narracore.app/llms.txt

Input Schema

Name	Required	Description
`text`	No	Raw screenplay text, one element per line (required when input_format="text")
`cover`	No	Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted; anonymous=true renders only title+date (competition blind-review convention — author/version stay off the page)
`paper`	No	Paper override for us/uk/fr: "letter" / "a4" / "a4_landscape" / "b4" (default follows style: us → letter, uk/fr → a4). Grid and page count are identical across papers. Vertical ja_* styles use a fixed sheet (omit)
`style`	No	Submission style: "us" (default — US Letter) / "uk" (A4, BBC-style margins, scene numbers on both sides) / "fr" (A4, French-style centered dialogue column) / vertical Japanese manuscript sheets "ja_business" (20×10, A4 landscape), "ja_standard" (20×20 400-character sheet, B4), "ja_kido" (20×40 Kido-style, A4 landscape) — pages = sheets. Rendering option — free to change within the same 24h screenplay bundle
`blocks`	No	Typed blocks (required when input_format="blocks")
`footer`	No	Explicit footer (centered below the text box); same value resolution as header
`header`	No	Explicit running header (overrides the default page-number line): field values come from cover; missing fields are skipped; page_number renders N/M at the right edge
`output`	No	pdf_and_blocks (default) / blocks_only / validate_only (free structure check, no render)
`include`	No	Receipt body shape (default both): blocks=typed blocks only, plain_text=formatted text only — halves the receipt for large screenplays; validate_only always echoes blocks
`request_id`	No	Idempotency key (optional)
`license_key`	No	License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)
`input_format`	No	text (default): line-based screenplay text parsed server-side. blocks: submit typed blocks directly — validated and rendered as-is, never re-classified.
`dialogue_breaks`	No	US submission convention for dialogue spanning a page break: (MORE) at the bottom of the page and SPEAKER (CONT'D) at the top of the next. Default false
`content_language`	No	Content language (default: auto-detect)

Output Schema

Name	Required	Description	Default
`ok`	Yes
`state`	No
`stats`	No
`blocks`	No
`reason`	No
`credits`	No
`message`	No
`pdf_url`	No
`pdf_meta`	No
`recovery`	No
`warnings`	No
`conflicts`	No
`next_step`	No
`pdf_bytes`	No
`confidence`	No
`plain_text`	No
`request_id`	No
`diagnostics`	No
`next_actions`	No
`contract_version`	No
`validation_status`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedOct 22, 2026

changedInput schema / properties / cover / description

Previous value: -"Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted"New value: +"Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted; anonymous=true renders only title+date (competition blind-review convention — author/version stay off the page)"

addedInput schema / properties / cover / properties / anonymous
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / dialogue_breaks

Added value: +{
+  "description": "US submission convention for dialogue spanning a page break: (MORE) at the bottom of the page and SPEAKER (CONT'D) at the top of the next. Default false",
+  "type": "boolean"
+}

addedInput schema / properties / paper

Added value: +{
+  "description": "Paper override for us/uk/fr: \"letter\" / \"a4\" / \"a4_landscape\" / \"b4\" (default follows style: us → letter, uk/fr → a4). Grid and page count are identical across papers. Vertical ja_* styles use a fixed sheet (omit)",
+  "maxLength": 24,
+  "type": "string"
+}

addedInput schema / properties / style

Added value: +{
+  "description": "Submission style: \"us\" (default — US Letter) / \"uk\" (A4, BBC-style margins, scene numbers on both sides) / \"fr\" (A4, French-style centered dialogue column) / vertical Japanese manuscript sheets \"ja_business\" (20×10, A4 landscape), \"ja_standard\" (20×20 400-character sheet, B4), \"ja_kido\" (20×40 Kido-style, A4 landscape) — pages = sheets. Rendering option — free to change within the same 24h screenplay bundle",
+  "maxLength": 24,
+  "type": "string"
+}

Changed2 schema fields changedOct 5, 2026

addedInput schema / properties / include

Added value: +{
+  "description": "Receipt body shape (default both): blocks=typed blocks only, plain_text=formatted text only — halves the receipt for large screenplays; validate_only always echoes blocks",
+  "enum": [
+    "blocks",
+    "plain_text",
+    "both"
+  ],
+  "type": "string"
+}

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "blocks": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "delivery": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "location": {
+            "type": "string"
+          },
+          "scene_number": {
+            "type": "string"
+          },
+          "speaker": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "time_of_day": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "type"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "confidence": {
+      "type": "number"
+    },
+    "conflicts": {},
+    "contract_version": {
+      "type": "string"
+    },
+    "credits": {
+      "additionalProperties": {},
+      "properties": {
+        "bundled": {
+          "type": "boolean"
+        },
+        "charged": {
+          "type": "number"
+        },
+        "free_tier_used": {
+          "type": "boolean"
+        },
+        "note": {
+          "type": "string"
+        },
+        "remaining": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "charged",
+        "remaining"
+      ],
+      "type": "object"
+    },
+    "diagnostics": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "block_id": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "line": {
+            "type": "number"
+          },
+          "message": {
+            "type": "string"
+          },
+          "severity": {
+            "type": "string"
+          },
+          "suggested_action": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "severity",
+          "message"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "message": {
+      "type": "string"
+    },
+    "next_actions": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "billing": {
+            "enum": [
+              "free",
+              "bundled",
+              "charged"
+            ],
+            "type": "string"
+          },
+          "purpose": {
+            "type": "string"
+          },
+          "requires": {
+            "type": "string"
+          },
+          "reuse_fields": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "tool": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "tool",
+          "purpose",
+          "requires",
+          "billing",
+          "reuse_fields"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "next_step": {
+      "type": "string"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "pdf_bytes": {
+      "type": "number"
+    },
+    "pdf_meta": {
+      "additionalProperties": {},
+      "properties": {
+        "bytes": {
+          "type": "number"
+        },
+        "expires_at_utc": {
+          "type": "string"
+        },
+        "filename": {
+          "type": "string"
+        },
+        "mime_type": {
+          "type": "string"
+        },
+        "pages": {
+          "type": "number"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "filename",
+        "mime_type",
+        "bytes",
+        "expires_at_utc",
+        "pages",
+        "url"
+      ],
+      "type": "object"
+    },
+    "pdf_url": {
+      "type": "string"
+    },
+    "plain_text": {
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "recovery": {
+      "additionalProperties": false,
+      "properties": {
+        "action": {
+          "type": "string"
+        },
+        "field_path": {
+          "type": "string"
+        },
+        "keep_request_id": {
+          "type": "boolean"
+        },
+        "note": {
+          "type": "string"
+        },
+        "resets_at_utc": {
+          "type": "string"
+        },
+        "retry_after_ms": {
+          "type": "number"
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "action",
+        "retryable",
+        "keep_request_id"
+      ],
+      "type": "object"
+    },
+    "request_id": {
+      "type": "string"
+    },
+    "state": {},
+    "stats": {
+      "additionalProperties": {},
+      "properties": {
+        "chars": {
+          "type": "number"
+        },
+        "content_language": {
+          "type": "string"
+        },
+        "input_blocks": {
+          "type": "number"
+        },
+        "page_starts": {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "pages": {
+          "type": "number"
+        },
+        "render_elements": {
+          "type": "number"
+        },
+        "scenes": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "input_blocks",
+        "render_elements",
+        "scenes",
+        "pages",
+        "page_starts",
+        "chars",
+        "content_language"
+      ],
+      "type": "object"
+    },
+    "validation_status": {
+      "type": "string"
+    },
+    "warnings": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "ok"
+  ],
+  "type": "object"
+}

Changed6 schema fields changedSep 19, 2026
- addedInput schema / properties / blocks / items / properties / text / maxLength
```
Added value: +200000
```
- addedInput schema / properties / cover / additionalProperties
```
Added value: +false
```
- addedInput schema / properties / cover / properties / author / maxLength
```
Added value: +2000
```
- addedInput schema / properties / cover / properties / date / maxLength
```
Added value: +64
```
- addedInput schema / properties / cover / properties / title / maxLength
```
Added value: +2000
```
- addedInput schema / properties / cover / properties / version / maxLength
```
Added value: +64
```

Changed3 schema fields changedSep 16, 2026

changedInput schema / properties / cover / description

Previous value: -"Cover page fields — any field present adds a cover page (not counted in page numbers)"New value: +"Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted"

addedInput schema / properties / footer

Added value: +{
+  "description": "Explicit footer (centered below the text box); same value resolution as header",
+  "properties": {
+    "items": {
+      "items": {
+        "enum": [
+          "title",
+          "author",
+          "date",
+          "version",
+          "page_number"
+        ],
+        "type": "string"
+      },
+      "maxItems": 5,
+      "minItems": 1,
+      "type": "array"
+    }
+  },
+  "required": [
+    "items"
+  ],
+  "type": "object"
+}

addedInput schema / properties / header

Added value: +{
+  "description": "Explicit running header (overrides the default page-number line): field values come from cover; missing fields are skipped; page_number renders N/M at the right edge",
+  "properties": {
+    "items": {
+      "items": {
+        "enum": [
+          "title",
+          "author",
+          "date",
+          "version",
+          "page_number"
+        ],
+        "type": "string"
+      },
+      "maxItems": 5,
+      "minItems": 1,
+      "type": "array"
+    }
+  },
+  "required": [
+    "items"
+  ],
+  "type": "object"
+}

First observedSep 16, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Annotations only declare the safety profile (readOnly=false, destructive=false, idempotent=false); the description adds a large amount beyond that: 24h-per-screenplay billing across the tool family, no charge on failure, request_id never double-charging, free tier behavior, quota-exhaustion handling instructions, the UNRESOLVED_STRUCTURE flag on wall-of-text input, and the meaning of the confidence field. Nothing here contradicts the annotations.

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

Conciseness4/5

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

Purpose is front-loaded and the mode/billing sections are cleanly bulleted. The billing paragraph is dense and somewhat sprawling for a tool description, but every block carries operational information an agent needs (modes, chaining, diagnostics, quota).

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

Completeness5/5

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

For a 14-parameter tool with nested objects and an output schema, the description covers the decision-relevant gaps: mode selection, chaining, diagnostics interpretation, confidence semantics, and billing/failure behavior. Return-value shape is delegated to the output schema, which is the correct division of labor.

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

Parameters5/5

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

Schema coverage is 100%, so the baseline is 3, but the description earns more: it explains the two input_format modes conceptually (line-per-element parsing rules vs. blocks rendered exactly as submitted, never re-classified), warns that blocks and text parse differently when chaining, and covers style/dialogue_breaks/cover.anonymous as free rendering options within the bundle.

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 first sentence names a specific verb (Convert) and precise resource (raw/loosely formatted screenplay text → structured blocks + print-ready PDF on a fixed typewriter grid). It scopes the input domain (Chinese/English/mixed, Japanese broadcast format, colon-style dialogue) and explicitly excludes general prose rewriting, so an agent can distinguish it from siblings like analyze_screenplay or convert_fountain.

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?

It states when to use it (formatting, import, shareable PDF) and when not to (general prose rewriting or story editing), plus a concrete free diagnostic path via output="validate_only" and the correct chaining pattern (pass back blocks, not text). It stops short of naming the sibling tools whose boundaries matter most (convert_fountain, render_bilingual_pdf, analyze_screenplay), leaving that routing to the agent.

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

All Narracore Screenplay Formatter tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.