Data model

Tools

MCP tools for creating and editing studies

Tool

Description

Input

Output

draft

Generate a new study draft from a research goal

researchGoal — a description of what you want to learn

Study draft, a sessionId, interactive preview (in supported clients)

edit

Refine an existing study draft using natural language

sessionId, editInstruction — natural language description of the change

Updated study draft

reorder

Change the order of steps in the study

sessionId, stepUuids — step UUIDs in the new order

Updated study draft with steps in the new order

deleteStep

Remove a step from the study

sessionId, stepUuid — UUID of the step to remove

Updated study draft with the step removed

publish

Publish the study to Ballpark

sessionId

URL to the published study in Ballpark