spawn_profiles

Lists the identities you can spawn an agent as in the current tenant: your own developer identity and any service profiles you are allowed to borrow. Each entry reports whether it is usable right now and, if not, why and how to fix it. Use it before spawn to discover what to pass to the service_profile parameter. Profiles you cannot assume are omitted. This is the discovery companion to spawning under a service profile. To inspect every defined profile — including ones you cannot borrow — read the service-profile catalog resource, for example with murmur get service-profile.

Parameters

This tool takes no parameters.

Response

Returns an array of identity entries.

Field	Type	Description
`type`	string	`self` for your own developer identity, or `service_profile` for a borrowable service profile.
`account`	string	The identity’s account. For a `service_profile` entry, pass this to `spawn`’s `service_profile` parameter to spawn under it. The `self` entry reports your own account (identifying who “self” is); to spawn as yourself, leave `service_profile` empty rather than passing the account.
`usable`	boolean	Whether this identity can be used to spawn right now.
`blocks`	object[]	Present only when `usable` is `false`. Each entry has a `reason` (what is unmet) and a `remediation` (how to fix it).
`description`	string	The profile’s description. Populated for service profiles.
`builtin`	boolean	`true` for platform-provided profiles.

For your own identity (self), the usable verdict is advisory — the server cannot see the credentials on your local machine, so a spawn as self may still succeed even when self is reported as blocked.

Examples

List spawn identities

{}

Response:

[
  {
    "type": "self",
    "account": "acme-dev",
    "usable": true
  },
  {
    "type": "service_profile",
    "account": "ci-builder",
    "usable": true,
    "description": "Opens PRs as the CI bot",
    "builtin": false
  },
  {
    "type": "service_profile",
    "account": "release-manager",
    "usable": false,
    "description": "Cuts release branches",
    "blocks": [
      {
        "reason": "missing service-profile.assume permission",
        "remediation": "ask an admin to grant you service-profile.assume on release-manager"
      }
    ]
  }
]

Spawn under a discovered profile

After confirming ci-builder is usable, pass its account to spawn:

{
  "slug": "nightly-build",
  "description": "Run the nightly build and open a PR with the results",
  "workspace": "ci",
  "service_profile": "ci-builder"
}

Errors

Code	Meaning	What to do
`UNAUTHENTICATED`	Identity token is missing or expired.	Check the host’s credentials.

murmur spawn-profiles — equivalent CLI command
spawn — spawn an agent, optionally under a service profile
Service profiles — bot identities agents can run as
MCP server — all Murmur MCP tools

Getting Started

Core Concepts

Guides

spawn_profiles

Parameters

Response

Examples

List spawn identities

Spawn under a discovered profile

Errors

​Parameters

​Response

​Examples

​List spawn identities

​Spawn under a discovered profile

​Errors

​Related

Parameters

Response

Examples

List spawn identities

Spawn under a discovered profile

Errors

Related