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. murmur get service-profile instead lists service profiles you can read with service-profile.read, regardless of whether you can assume them. Neither listing confers the permission used by the other.

Parameters

This tool takes no parameters. Passing any argument is an error.

Response

Returns an object with a profiles key containing the identities you may spawn as, or [] when you have none. When you have folders, the object also includes a folders key with your complete dashboard folder list. The folders key is absent, not empty, when the caller has no folders.

`profiles[]`

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. Present only for service profiles that have one.
`builtin`	boolean	`true` for platform-provided profiles. Absent otherwise.

`folders[]`

Your complete personal folder list, including folders holding no agent. This is the folder listing every folder tool reads: pass a name to folder, folder_assign, or spawn’s folder parameter. The key is absent when you have no folders.

Field	Type	Description
`folder_id`	string	The folder’s stable id, unchanged by a rename. No tool takes it as input: folders are named by `name`.
`name`	string	The display label, and what every folder tool takes to name the folder.
`agent_count`	number	How many agents are filed in the folder, including any the dashboard is filtering out of view. This is what a `folder` delete would unfile.

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:

{
  "profiles": [
    {
      "type": "self",
      "account": "acme-dev",
      "usable": false,
      "blocks": [
        {
          "reason": "your account has no GitHub credential",
          "remediation": "sign in to the dashboard to connect GitHub, or store a GH_TOKEN with 'murmur setup' (CLI) or in dashboard Settings"
        }
      ]
    },
    {
      "type": "service_profile",
      "account": "ci-builder",
      "usable": true,
      "description": "Opens PRs as the CI bot"
    }
  ],
  "folders": [
    {
      "folder_id": "fld-9f2c41ab77de",
      "name": "Infra",
      "agent_count": 4
    },
    {
      "folder_id": "fld-c07be31d5a94",
      "name": "Review queue",
      "agent_count": 0
    }
  ]
}

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.

folder: create, rename, or delete a folder
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

`profiles[]`

`folders[]`

Examples

List spawn identities

Spawn under a discovered profile

Errors

​Parameters

​Response

​profiles[]

​folders[]

​Examples

​List spawn identities

​Spawn under a discovered profile

​Errors

​Related

Parameters

Response

`profiles[]`

`folders[]`

Examples

List spawn identities

Spawn under a discovered profile

Errors

Related