create_narrative_aspect
ChatGPTUse when the writer asks to save exact approved Narrative Aspects in an owned Storyform. Save explicitly approved Storyform Narrative Aspects using the store operation. Requires OAuth, an eligible Dramatica account, and the mcp:write scope. May upsert matching records, restore deleted aspects, or replace saved Dynamic values and other supplied fields. Existing Storytelling overwrite guards apply; this is not an insert-only operation. Read the target first and obtain explicit confirmation of the exact changes.
delete_narrative_aspect
ChatGPTUse when the writer asks to remove one identified Narrative Aspect from an owned Storyform. Soft-delete one explicitly identified Storyform Narrative Aspect. Requires OAuth, an eligible Dramatica account, the mcp:write scope, and the writer's explicit confirmation.
execute_tools
ChatGPTExecute one or more independent catalog tools synchronously in order. Pass {"calls":[{"name":"tool_name","arguments":{"key":"value"}}]} using exact names and arguments returned by search_tools. Execution stops on the first error. If a call depends on a previous result, invoke execute_tools again with a new calls array.
get_appreciation
ChatGPTLook up the authoritative Dramatica definition of one concept, such as Outcome, Judgment, or Main Character Resolve, when the writer asks what that concept means. Resolve by shorthand (preferred), slug, or name; return the saved definition and usage prompts. Requires OAuth and an eligible Dramatica account. Read-only; does not analyze a manuscript or change saved work.
get_narrative_function
ChatGPTLook up one Dramatica Narrative Function, such as Progress, Logic, or Avoidance, when the writer asks about its meaning in Dramatica rather than its unrelated everyday meaning. Resolve by semantic id, slug, name, or synonym. Requires OAuth and an eligible Dramatica account. Read-only; does not assign a Narrative Function to the writer's story or change saved work.
get_storyform
ChatGPTInspect the existing structure of an accessible saved Storyform or canonical example. Use storyform_uuid (preferred), storyform_id, story_uuid, or title lookup. By default, return lean core key/value structure. Set include_memory=true only when the writer needs the saved memory index for Players and their Narrative Functions across Motivation, Purpose, Evaluation, and Methodology, Perspectives, Storypoints, Storybeats, Dynamics, and alias-based component lookup. Title lookup supports owned Storyforms; set is_example=true for canonical example titles. Requires OAuth, an eligible Dramatica account, and access to the requested Storyform. Read-only; does not infer a new Storyform from a screenplay or manuscript, validate proposed constraints, or save changes.
list_user_stories
ChatGPTFind the authenticated writer's saved Stories and related Storyforms, with UUIDs, when the writer asks what saved work is available or needs a target for inspection. Requires OAuth, an eligible Dramatica account, and ownership of the listed data. Read-only; does not search canonical examples, analyze an uploaded manuscript, or create a Story.
open_storyform_workspace
ChatGPTOpen the read-only Dramatica workspace when the writer wants to browse saved Stories or visually inspect a selected Storyform beside the conversation. Pass storyform_uuid only when the selected UUID is already known; otherwise open the Story picker. Requires OAuth and an eligible Dramatica account. Access to the selection is checked when it loads. Does not infer a Storyform from prose or change saved work.
read_storyform_workspace
ChatGPTLoad owned Stories, a selected Storyform's canonical structure, or one bounded Storytelling excerpt for the Dramatica workspace UI. Requires OAuth and an eligible Dramatica account. Available only to the app UI; does not return another writer's Storyform, a full memory index, or mutate saved work.
report_feedback
ChatGPTSend feedback about a Dramatica MCP tool or missing capability to Dramatica support. Show the writer the exact report and tell them it will be sent to support with their Dramatica account name and email. Ask them to approve that report before calling this tool. Summarize the goal and outcome in your own words. Leave out private Storytelling, conversation transcripts, raw tool payloads, credentials, and personal details. Requires OAuth with the mcp:use scope.
save_storyform_component
ChatGPTSave an explicitly approved component in an owned Dramatica Storyform: Overview, Perspective, Storypoint, Dynamic, Storybeat, or Player. Supports a single component or supported component batch. May create, upsert, or restore records and replace supplied Dynamic values, including corresponding stored Storyform fields. Requires OAuth, an eligible Dramatica account, and the mcp:write scope. Read the target first and obtain explicit confirmation of the exact changes. Existing Storytelling overwrite guards apply; this is not an insert-only operation.
show_story_elements
ChatGPTShow an interactive canonical Dramatica chart inline in ChatGPT, with clickable definitions, nested quads, highlights, optional Storypoint labels, and illustrative Storytelling. Use when the writer asks to see the chart or a quad, or a chart clarifies an explanation. Quad displays focus and its siblings; children displays the children of focus; table displays the four Classes. Resolve repeated names with a Domain or returned chart placement ID, not an Element semantic ID. Never invent positions. When showing a saved Storyform, verify its values with get_storyform and label the relevant tiles (for example MC Problem, MC Solution, MC Symptom, MC Response). Labels describe this context, not permanent Element roles. Omit for general theory charts. Requires OAuth and an eligible account. Read-only; does not assign or save a Storyform. Illustrations are conversational examples, not canonical definitions or saved Storytelling.
update_narrative_aspect
ChatGPTUse when the writer asks to revise one identified Narrative Aspect in an owned Storyform. Update one explicitly approved saved Storyform Narrative Aspect. Requires OAuth, an eligible Dramatica account, and the mcp:write scope. Defaults to preserving existing authored prose; use replace mode only when the writer explicitly approves replacing it.