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. For `trigger-new-or-updated-pipeline`, `pipeline` is present only when the automation is scoped to one pipeline.
`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.

Use the Automation data type for the selectable fields that can be requested through automation MCP tools.

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