Creating Agents via MCP: Draft, Review, and Activate

How the draft-first workflow works when creating prompt-based agents through the GoMarble MCP — save an agent as a draft, review it, then activate it when ready.

Written By GoMarble

Last updated 11 days ago

Overview

When you create a prompt-based agent using the GoMarble MCP manage_agents tool, the agent is saved in draft mode by default. This means the agent is persisted in your account but is not running until you explicitly activate it. This gives you a chance to review the agent's configuration before it goes live.

Note: Report-based agents are not affected by this change — they are always created as live.

The Draft → Review → Activate Lifecycle

  1. Create the agent via prompt. When you ask the MCP to create a new prompt-based agent, it is saved as a draft by default. You will see it appear in your account in a draft state, not yet running.

  2. Review the draft. Open the agent's review card in GoMarble to check its configuration — goals, schedule, governance settings, and any other details — before committing to activation.

  3. Activate the agent. When you are satisfied with the configuration, explicitly activate the agent. Activation routes through GoMarble's activation engine, including any required entitlement checks, and the agent will begin running from that point.

Going Live Immediately

If you want an agent to go live at the moment of creation — skipping the draft step — you can explicitly request this when instructing the MCP tool. Only use this option when you are confident in the configuration upfront.

Fleet Grouping

When creating multiple related agents as part of an onboarding setup, you can group them into a fleet. A fleet bundles related agents together so they can be reviewed and activated in a single step, rather than one by one.

To use fleet grouping, provide a fleet ID and a role for each agent when creating them through the MCP tool. Once all agents in the fleet are ready, you can activate the entire fleet at once.

Key Points to Remember

  • Prompt-based agents default to draft mode — they will not run until activated.

  • Report-based agents are always created live and are unaffected by this workflow.

  • You can review an agent's full configuration before activating it.

  • Fleet grouping lets you activate a set of related agents together in one step.