MCP Tools
ingestion_status
Check the status of an ingestion job.
Check the status of an ingestion job. Returns progress, timing, and any errors.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
jobId | string (UUID) | Yes | Job ID from ingestion_trigger or subscription_create |
Example
Prompt
Check the status of ingestion job job_xyz789Response (running)
{
"job": {
"id": "job_xyz789",
"status": "running",
"creatorId": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"postLimit": 30,
"createdAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z",
"startedAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>05</NUMBER>Z"
},
"progress": {
"postsFound": 15,
"postsProcessed": 12,
"percentComplete": 40
}
}Response (completed)
{
"job": {
"id": "job_xyz789",
"status": "completed",
"creatorId": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"postLimit": 30,
"createdAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z",
"startedAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>05</NUMBER>Z",
"completedAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>45</NUMBER>Z"
},
"progress": {
"postsFound": 30,
"postsProcessed": 30,
"percentComplete": 100
},
"result": {
"newPosts": 25,
"duplicates": 5,
"errors": 0
}
}Response (failed)
{
"job": {
"id": "job_xyz789",
"status": "failed",
"creatorId": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"createdAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z",
"startedAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>05</NUMBER>Z",
"failedAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>15</NUMBER>Z"
},
"error": {
"code": "service_error",
"message": "Platform rate limit exceeded",
"retryable": true
}
}Response Fields
job
| Field | Type | Description |
|---|---|---|
id | string | Job UUID |
status | string | queued, running, completed, failed |
startedAt | string | When processing began |
completedAt | string | When job finished (if completed) |
failedAt | string | When job failed (if failed) |
progress
| Field | Description |
|---|---|
postsFound | Posts discovered from platform |
postsProcessed | Posts saved to database |
percentComplete | Overall progress (0-100) |
result (when completed)
| Field | Description |
|---|---|
newPosts | New posts added to stash |
duplicates | Posts already in stash (skipped) |
errors | Posts that failed to process |
Use Cases
- Monitor long-running ingestion jobs
- Verify content was successfully fetched
- Debug failed ingestion attempts