list_modeling_projects
Retrieves a paginated list of all SysML v2 projects accessible to the user, separating library projects from user-created projects.
Purpose
This tool is essential for project discovery and provides key metadata including project IDs, names, descriptions, default branch IDs, and timestamps. Use this as the starting point for model exploration to identify which projects are available and obtain their IDs for subsequent operations.
Tags: AM Read Standard
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit |
integer | No | 100 | Number of projects per page (1-250) |
page |
integer | No | 1 | Page number for pagination |
Output schema
| Field | Type | Description |
|---|---|---|
| summary.total_projects | integer | Total number of projects accessible to the user |
| summary.library_projects_count | integer | Number of library projects |
| summary.user_projects_count | integer | Number of user-created projects |
| summary.returned_count | integer | Number of projects returned in this response |
| summary.has_more | boolean | Indicates if more projects are available on subsequent pages |
| summary.next_page | integer | Next page number (only present if has_more is true) |
| library_projects[].projectId | string | Unique identifier for the library project |
| library_projects[].name | string | Name of the library project |
| library_projects[].description | string | Description of the library project |
| library_projects[].defaultConfigurationId | string | UUID of the default branch configuration |
| library_projects[].created | string | ISO 8601 timestamp when the project was created |
| library_projects[].lastModified | string | ISO 8601 timestamp when the project was last modified |
| user_projects[].projectId | string | Unique identifier for the user project |
| user_projects[].name | string | Name of the user project |
| user_projects[].description | string | Description of the user project |
| user_projects[].defaultConfigurationId | string | UUID of the default branch configuration |
| user_projects[].created | string | ISO 8601 timestamp when the project was created |
| user_projects[].lastModified | string | ISO 8601 timestamp when the project was last modified |
Common use cases
- Project discovery
- List all available projects for model exploration. For example: Show me all available SysML projects.
- Library identification
- Identify standard library projects versus user projects. For example: Which projects are library projects?
- Project selection
- Get project IDs for use in other tool calls. For example: Find the project ID for "Vehicle system model".