Automation MCP response
MCP tool response returned by the Search automations, Create automation, and Update automation MCP tools.
- Returned by: Search automations MCP tool; Create automation MCP tool; Update automation MCP tool
- Response type: Structured automation record
Response Shape
The returned automation record can include identity fields, the current prompt, trigger details, run-history snapshots, and status metadata.
| Field | Type | Notes |
|---|---|---|
govtribe_id | string | GovTribe ID for the automation. Pass this value into workflow_id for update, delete, or test-run calls. |
govtribe_type | string | GovTribe record type for the automation row. |
govtribe_url | string | GovTribe URL for the automation detail page. |
name | string | Automation name. |
prompt | string | Prompt GovTribe AI runs when the automation fires. |
trigger_details | object | Trigger snapshot. Schedule triggers include cadence details such as frequency, timezone, rrule, time_of_day, day_of_week, and next_run_at. Saved-search, pipeline, and stage triggers include the trigger summary plus the relevant scoped objects. |
state | string | Current automation state such as published, paused, or broken. |
paused_at | string | Conditional field returned when the automation is paused. |
version_number | integer | Active automation version number. |
last_ran_at | string or null | Start time of the most recent run. |
govtribe_ai_project_name | string or null | Name of the linked GovTribe AI project. |
created_at | string | Automation creation timestamp. |
updated_at | string | Automation update timestamp. |
total_runs_count | integer | Total number of recorded runs for the automation. |
past_runs | object array or null | Most recent run snapshots. Each item includes id, state, is_user_initiated_test, started_at, finished_at, and memory. |
broken_details | object | Conditional field returned when the active automation version is broken. Includes what_happened and how_to_fix. |
Follow-up Behavior
Search_Automations returns only govtribe_id when you omit fields_to_return.
Search_Automations uses past_runs_limit to decide whether past_runs is present. Set past_runs_limit to 0 when you do not want embedded run history.
When an automation is paused, GovTribe also includes paused_at even if you did not request it explicitly in fields_to_return.
When an automation is broken, GovTribe also includes broken_details even if you did not request it explicitly in fields_to_return.
Example
{
"govtribe_id": "AUTOMATION_ID",
"govtribe_url": "https://govtribe.com/workspace/WORKSPACE_ID/oai-response/automations/AUTOMATION_ID",
"name": "Weekly capture recap",
"prompt": "Review recent opportunity activity, highlight the biggest capture changes, and draft a concise weekly recap for our team.",
"trigger_details": {
"trigger_type": "trigger-schedule",
"summary": "Mondays at 9:15 AM",
"frequency": "weekly",
"timezone": "America/New_York",
"rrule": "RRULE:FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=15",
"time_of_day": "09:15",
"day_of_week": "MO",
"next_run_at": "2026-06-01T13:15:00Z"
},
"state": "paused",
"paused_at": "2026-05-27T16:45:00Z",
"version_number": 2,
"last_ran_at": "2026-05-27T17:55:16Z",
"govtribe_ai_project_name": "Capture Reviews",
"created_at": "2026-05-20T13:15:00Z",
"updated_at": "2026-05-27T14:00:00Z",
"total_runs_count": 4,
"past_runs": [
{
"id": "WORKFLOW_RUN_ID",
"state": "processed",
"is_user_initiated_test": true,
"started_at": "2026-05-27T17:55:16Z",
"finished_at": "2026-05-27T17:55:18Z",
"memory": "Memories are not created for manual test runs."
}
]
}