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, completion email settings, 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.
`on_completion_notify_user`	string	Completion email setting. Values are `always`, `conditionally`, and `never`. GovTribe returns `never` when no completion email is configured.
`completion_notification_instructions`	string or null	Condition and email-writing guidance for the completion email. Required when `on_completion_notify_user` is `conditionally`, optional when it is `always`, and null when no instructions are configured.
`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.

Request on_completion_notify_user and completion_notification_instructions before calling Update_Automation when you need to inspect or change completion email behavior. Update_Automation accepts the same flat keys. Omit both completion email fields to preserve the existing setting, or set on_completion_notify_user to never to turn completion emails off. Do not send internal notification_node or notification_config fields.

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.",
  "on_completion_notify_user": "always",
  "completion_notification_instructions": "Start with the highest-priority finding, then summarize the rest in bullets.",
  "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."
    }
  ]
}

Response Shape

Follow-up Behavior

Example

On this page