GET

get_snapshot_status

Checks the processing status of a snapshot. Since snapshot creation is asynchronous, poll this tool until the status reaches completed before running simulations.

Returns the current processing state, progress percentage, and any error messages if issues occur.

Parameters

mindId

Type	string
Required	Yes
Description	The mind ID from the `create_mind` response

snapshotId

Type	string
Required	Yes
Description	The `mindAssessmentId` from the `create_snapshot` response

Request

1 {
2   "mindId": "abc-123-def-456",
3   "snapshotId": "snapshot-123-abc-456"
4 }

Response Examples

While Processing

1 {
2   "id": "123e4567-e89b-12d3-a456-426614174003",
3   "mindId": "123e4567-e89b-12d3-a456-426614174000",
4   "status": "processing",
5   "startedAt": "2025-01-15T10:00:00.000Z",
6   "completedAt": null
7 }

Training is in progress. Continue polling every 30-60 seconds.

Training Finished

1 {
2   "id": "123e4567-e89b-12d3-a456-426614174003",
3   "mindId": "123e4567-e89b-12d3-a456-426614174000",
4   "status": "completed",
5   "startedAt": "2025-01-15T10:00:00.000Z",
6   "completedAt": "2025-01-15T10:05:00.000Z"
7 }

Training is complete. Model is ready for simulations using the simulate tool.

Training Error

1 {
2   "id": "123e4567-e89b-12d3-a456-426614174003",
3   "mindId": "123e4567-e89b-12d3-a456-426614174000",
4   "status": "failed",
5   "startedAt": "2025-01-15T10:00:00.000Z",
6   "completedAt": "2025-01-15T10:02:00.000Z"
7 }

Training failed. Check the error message or try uploading more data.

Response Properties

Property	Type	Description
`id`	string	Snapshot identifier (matches snapshotId parameter)
`mindId`	string	Associated mind identifier
`status`	string	Current status: `processing`, `completed`, or `failed`
`startedAt`	string	ISO 8601 timestamp when training started
`completedAt`	string \| null	ISO 8601 timestamp when training finished (null if still processing)

Status Reference

processing

Meaning: AI model is still training on your data

Next Action: Continue polling every 30-60 seconds

Typical Duration: 5-15 minutes for most files

completed

Meaning: Training succeeded and model is ready

Next Action: Proceed to the simulate tool

Details: The completedAt timestamp indicates when processing finished

failed

Meaning: Processing encountered an error

Next Action: Check the error message and address the issue before retrying

Common Causes: Insufficient data, corrupted files, or format issues

Polling Best Practices

Recommended polling strategy:

First 5 minutes: Poll every 30 seconds
After 5 minutes: Increase to 60-second intervals
Maximum timeout: 30 minutes
On error: Stop polling and check error message

Your AI assistant handles this automatically.

Error Responses

404 Not Found

1 {
2   "error": "Not Found",
3   "message": "Snapshot with ID 'snapshot-123' does not exist"
4 }

Solution: Verify the snapshotId is correct and ensure you’re using the mindAssessmentId from create_snapshot.

401 Unauthorized

1 {
2   "error": "Unauthorized",
3   "message": "Invalid or missing API key"
4 }

Solution: Verify your API key in the MCP server configuration and ensure the format is correct: Bearer YOUR_KEY.

Next Steps

Run Simulations

simulate - Generate predictions using the trained model