MCP for agents

OutcomeOS exposes its actions as MCP tools over Streamable HTTP at https://outcomeos.cloud/mcp. Authenticate with an API key.

{
  "mcpServers": {
    "outcomeos": {
      "url": "https://outcomeos.cloud/mcp",
      "headers": {
        "Authorization": "Bearer oos_your_key"
      }
    }
  }
}

Tools run through the same permission, plan and validation checks as the dashboard. Destructive tools (deleting, replaying, running workflows) are flagged with destructiveHint so clients ask before calling them. Secrets (API keys, webhook secrets, billing) are not exposed as tools.

Tools (48)

Tool	Description
`list_outcomes`	List outcomes with progress, verified counts and status.
`get_outcome`	Get one outcome: success criteria, verification config, progress and linked workflows.
`create_outcome`	Create a business outcome with explicit success criteria and a verification method.
`update_outcome`	Update an outcome's definition, or cancel / reactivate it (status: cancelled \| not_started).
`delete_outcome`destructive	Delete an outcome and its events. Linked workflows are kept and unlinked.
`list_outcome_events`	List the latest events recorded for an outcome, with whether each was counted as verified.
`list_outcome_subjects`	List evaluated subjects (e.g. leads, invoices) with achieved / failed / pending status and reason.
`ingest_outcome_event`	Record an outcome event (e.g. customer.reply_received for a lead). Counted only if its source is trusted by the outcome.
`list_workflows`	List workflows with trigger, linked outcome, status, executions and success rate.
`validate_workflow`	Validate a workflow definition without saving it.
`get_workflow`	Get a workflow: draft definition, webhook URL and version history.
`create_workflow`	Create a draft workflow, empty, from a template id, or from a JSON definition.
`update_workflow`	Save the draft (name, description, linked outcome, definition). Returns validation issues; publishing requires none.
`publish_workflow`	Publish the draft as a new immutable version. Running executions keep the version they started with.
`set_workflow_status`	Activate or deactivate a published workflow. Inactive workflows reject webhook triggers.
`duplicate_workflow`	Copy a workflow's draft into a new draft workflow.
`delete_workflow`destructive	Delete a workflow, its versions and execution history.
`test_workflow`destructive	Run the current draft once with a sample payload. Test runs never record outcome events.
`run_workflow`destructive	Start an execution of the published version with a JSON payload (same as the webhook trigger, authenticated by API key).
`get_workflow_version`	Get the immutable definition of a published version.
`list_executions`	List executions, newest first. Filter by status (use `attention` for failed + requires_attention), workflow or outcome.
`get_execution`	Get an execution's full step timeline: inputs, outputs, errors, retries, logs (secrets masked) and related outcome events.
`replay_execution`destructive	Replay a failed, cancelled or attention-required execution. Default mode reuses steps that already succeeded and re-runs from the failure.
`cancel_execution`destructive	Cancel a pending, running or waiting execution. Steps already in flight finish; nothing new starts.
`list_integration_catalog`	List every integration with its real availability: available, beta, needs operator setup, or coming soon.
`list_connections`	List connections. Credentials are never returned; only which secret fields are set.
`create_connection`	Save a connection (status pending). It only becomes connected after test_connection succeeds against the real provider.
`update_connection`	Update a connection's name or credentials. Changing credentials resets it to pending until tested again. Blank secret fields keep the stored value.
`test_connection`	Verify a connection against the real provider. Marks it connected only on success; otherwise records the provider's error.
`delete_connection`destructive	Delete a connection and its encrypted credentials. Workflow steps using it will fail with needs_credentials.
`submit_community_connector`	Submit (or resubmit) a declarative community connector for review. Once approved it is listed in the marketplace and anyone can connect it. A resubmission goes back to review while the approved version stays live.
`list_my_community_connectors`	List community connectors your organization has submitted, with review status and reviewer notes.
`get_organization`	Get the active organization: plan, limits, usage, workspaces and your role.
`update_organization`	Rename the organization.
`create_workspace`	Create a workspace inside the organization.
`list_members`	List organization members and their roles.
`update_member_role`	Change a member's role (admin, editor, viewer).
`remove_member`destructive	Remove a member from the organization. Their API keys for this org are revoked.
`list_invitations`	List pending invitations.
`revoke_invitation`destructive	Revoke a pending invitation.
`list_audit_logs`	List audit log entries for the organization, newest first.
`list_templates`	List outcome and workflow templates.
`get_overview`	Dashboard overview: active outcomes, verified results, success rate, running and failed executions, recent activity. scope=real (default) or scope=demo; demo and real data are never combined.
`get_analytics`	Outcome and workflow analytics computed from recorded executions and verified outcome events. scope=real (default) or scope=demo; demo and real data are never combined.
`list_assistant_proposals`	List recent assistant proposals.
`propose_automation`	Turn a plain-language goal into a proposed outcome and draft workflow. Nothing is created until the proposal is approved.
`approve_assistant_proposal`	Approve a proposal: creates the outcome and a draft (unpublished) workflow linked to it.
`reject_assistant_proposal`	Reject a proposal. Nothing is created.