Add to container MCP response
MCP tool response returned by the Add to container MCP tool.
- Returned by: Add to container MCP tool
- Response type: Structured status snapshot
Response Shape
The tool returns a text message plus the same status details as structured content.
| Field | Type | Notes |
|---|---|---|
status | string | Operation status. Values are in_progress, completed, or failed. |
message | string | Human-readable status message for the current snapshot. |
container_id | string | GovTribe container owner identifier for the operation. |
oai_container_id | string | Hosted OpenAI container identifier when one exists. |
requested_file_count | integer | Number of files requested for the container operation. |
completed_file_count | integer | Number of requested files already attached. |
pending_file_count | integer | Number of requested files still being attached. |
failed_file_count | integer | Number of requested files that failed attachment. |
completed_file_names | string array | File names already available in the hosted container. |
pending_file_names | string array | File names still being uploaded or attached. |
failed_file_names | string array | File names that failed attachment. |
skipped_file_names | string array | File names skipped by the tool before upload. |
hosted_tool_ready | boolean | Whether the hosted shell tool can use the completed files now. |
retry_with_same_arguments | boolean | Whether the agent should call the same tool again later with identical arguments. |
Follow-up Behavior
When status is in_progress and retry_with_same_arguments is true, call Add_To_Container again later with the same arguments to get a fresh status snapshot.
Do not use hosted shell files while status is in_progress or hosted_tool_ready is false.
When status is completed and hosted_tool_ready is true, the completed files are ready for the hosted shell tool under /mnt/data.
Example
{
"status": "in_progress",
"message": "2 of 3 files are available in the hosted container. 1 file is still being attached.",
"container_id": "CONTAINER_ID",
"oai_container_id": "OAI_CONTAINER_ID",
"requested_file_count": 3,
"completed_file_count": 2,
"pending_file_count": 1,
"failed_file_count": 0,
"completed_file_names": ["pricing-summary.pdf", "requirements.xlsx"],
"pending_file_names": ["technical-volume.docx"],
"failed_file_names": [],
"skipped_file_names": [],
"hosted_tool_ready": false,
"retry_with_same_arguments": true
}