> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# goose

> Add Spiral to Block's goose as a remote extension: paste one link, sign in, no API key.

**1. Add the extension**

In goose Desktop, open the sidebar, click **Extensions**, then **Add custom extension**. Enter:

* **Extension Name:** `Spiral`
* **Type:** **Streamable HTTP**
* **Endpoint:** `https://api.spiral.ai/mcp`

Leave **Request Headers** empty and click **Add**. No client ID or secret: goose registers itself with Spiral.

In the goose CLI instead, run `goose configure`, choose **Add Extension**, then **Remote Extension (Streamable
HTTP)**. Name it `spiral`, enter the URL above and answer **No** to custom headers.

**2. Sign in**

When goose first connects to Spiral, your browser opens. Sign in to Spiral, pick the organization and click
**Authorize**. No API key. If the browser does not open, goose prints the link to open yourself.

**3. Try a starter prompt**

Start a session (`goose session` in the CLI) and ask:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

> [accordion] With an API key instead
>
> Create a key in the [console](https://spiral.ai/start) under **API keys**. Add the extension as above, and
> under **Request Headers** (or **Yes** to custom headers in the CLI) add the header name `Authorization` with the value
> `Bearer <your API key>`.
>
> Or edit `~/.config/goose/config.yaml` directly, and keep it private:
>
> ```yaml theme={null}
> extensions:
>   spiral:
>     name: spiral
>     type: streamable_http
>     uri: https://api.spiral.ai/mcp
>     headers:
>       Authorization: Bearer <your API key>
>     enabled: true
>     timeout: 300
> ```

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.