MCP Tools
ingestion_trigger
Trigger content ingestion for a subscribed creator.
Trigger content ingestion for a subscribed creator. Fetches new posts asynchronously. Use ingestion_status to check progress.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
creatorId | string (UUID) | Yes | Creator to fetch content from |
platform | string | Yes | Platform: x, instagram, tiktok, youtube, linkedin |
handle | string | Yes | Creator's handle/username |
postLimit | number | No | Posts to fetch (1-100, default: 20) |
Example
Prompt
Fetch the latest 30 posts from @navalResponse
{
"job": {
"id": "job_xyz789",
"status": "queued",
"creatorId": "550e8400-e29b-41d4-a716-446655440000",
"platform": "x",
"handle": "naval",
"postLimit": 30,
"createdAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z"
},
"message": "Ingestion job queued. Use ingestion_status to check progress."
}Response Fields
job
| Field | Type | Description |
|---|---|---|
id | string | Job ID for status checks |
status | string | queued, running, completed, failed |
creatorId | string | Target creator |
postLimit | number | Posts requested |
Job Lifecycle
queued→running→completedorfailed
Use Cases
- Manually refresh content from a creator
- Bulk fetch historical posts
- Re-sync after a period of inactivity
Notes
- Jobs run asynchronously and may take 30-60 seconds
- Each ingestion counts against your monthly limit
- Duplicate posts are automatically deduplicated