create_project

Use create_project to start a new model workspace

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name for the new project. Must be unique within the workspace, URL-safe, and contain only alphanumeric characters, hyphens, and underscores.')]	Yes	—
scaffold	Annotated[bool, Field(description='When true (default), seeds the project with an auto-discovery run.py and a starter financial model. When false, creates a minimal empty project.')]	No	True
description	Annotated[str, Field(description='Optional human-readable description for the project.')]	No	''

Returns

Returns a structured object. Top-level fields:

• project (string)
• description (string)
• run_py (string)
• model_py (string)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "create_project",
  "arguments": {
    "project_name": "forecasts",
    "scaffold": true,
    "description": "FY26 revenue and cash forecasts"
  }
}

Response

{
  "project": "forecasts",
  "description": "FY26 revenue and cash forecasts",
  "run_py": "# scaffolded run.py content...",
  "model_py": "# scaffolded model/my_model.py content..."
}

Notes

• Module: Projects
• Requires authentication via API token or Auth0 JWT.