docs: add Alby MCP tutorial

[rolznz]

This tutorial instructs on how to enable goose to seamlessly interact with bitcoin lightning wallets using the Nostr Wallet Connect protocol.

You can seamlessly connect to a variety of lightning wallets, including Alby Hub which is powered by Lightning Dev Kit

Example prompts:

• "Pay $1 to my friend Rene"
• "Make me a 10 sat invoice"
• "Was it paid?" (check if the invoice was paid)
• "Pay lnbc...." (pay an invoice)
• "What's my balance?"
• "What's the alias of my lightning node?"

Alby MCP can be also used to seamlessly use paid MCP tools, such as the Bitrefill MCP server ("buy me a 200THB Lotus's gift card") and e.g. a paid weather server ("What's the weather in Wellington?")

The tutorial has instructions for both STDIO and remote (SSE)

[agiuliano-square]

Thanks so much for this contribution @rolznz! This looks great! I just had one small clarifying question.

[agiuliano-square]

It may be that I'm just not too familiar with this tool, but this has a bit of a smell to me. Is there any other way to get this endpoint?

[rolznz]

Ideally Goose supports Bearer auth. Then the connection secret can be passed e.g. Authorization: Bearer nostr+walletconnect://... - but I don't think Goose supports this yet?

[rolznz]

Please let me know if there's a way to do authentication for remote MCPs in Goose. The current method is a workaround, and I will update it as soon as we have something better available.

[rolznz]

Linking #2423

[blackgirlbytes]

Hi @rolznz !!! Thank you so much for adding this tutorial. This is awesome. Only thing I had as a preference would be to nest the Local and Remote options in tabs under Goose Desktop and Goose CLI. Something like this

<Tabs groupId="interface">
  <TabItem value="desktop" label="Goose Desktop">
    <Tabs>
      <TabItem value="local" label="Local">
        1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40getalby%2Fmcp&id=alby&name=Alby&description=Connect%20Goose%20to%20your%20Bitcoin%20Lightning%20Wallet&env=NWC_CONNECTION_STRING%3DNWC%20Connection%20Secret)
        2. Press `Yes` to confirm the installation
        3. Obtain a NWC Connection secret from your lightning wallet (`nostr+walletconnect://...`) and paste it in to the "NWC Connection Secret" field
        4. Click `Add Extension`
        5. Scroll to the top and click `Exit` from the upper left corner
      </TabItem>
      <TabItem value="remote" label="Remote">
        1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40getalby%2Fmcp&id=alby&name=Alby&description=Connect%20Goose%20to%20your%20Bitcoin%20Lightning%20Wallet)
        2. Press `Yes` to confirm the installation
        3. Change the type to "Server-Sent Events (SSE)"
        4. Change the endpoint. To get your endpoint URL, open browser devtools (right click -> inspect) and enter this in the console, with your own NWC connection secret set:
            ```js
              "https://mcp.getalby.com/sse?nwc=" + encodeURIComponent("nostr+walletconnect://...");
            ```
        5. Copy the value, and paste it into the endpoint field.
        6. Click `Add Extension`
        7. Scroll to the top and click `Exit` from the upper left corner
      </TabItem>
    </Tabs>
  </TabItem>
  <TabItem value="cli" label="Goose CLI">
    <Tabs>
      <TabItem value="local" label="Local">
        1. Run the `configure` command:
        ```sh
        goose configure
        ```

        2. Choose to add a `Command-line Extension`
        3. Give your extension a name (e.g., "Alby")
        4. Enter the command: `npx -y @getalby/mcp`
        5. Set the timeout (default is 300 seconds)
        6. Choose whether to add a description
        7. Add the environment variable:
           - Name: `NWC_CONNECTION_STRING`
           - Value: Your NWC connection secret (`nostr+walletconnect://...`)
      </TabItem>
      <TabItem value="remote" label="Remote">
        1. Run the `configure` command:
        ```sh
        goose configure
        ```

        2. Choose to add a `Remote Extension`
        3. Give your extension a name (e.g., "Alby")
        4. Enter the SSE endpoint URI:
           ```
           https://mcp.getalby.com/sse?nwc=YOUR_ENCODED_CONNECTION_SECRET
           ```
           To get the endpoint URL, open browser devtools and enter this in the console, with your own NWC connection secret:
           ```js
           "https://mcp.getalby.com/sse?nwc=" + encodeURIComponent("nostr+walletconnect://...");
           ```
        5. Set the timeout (default is 300 seconds)
        6. Choose whether to add a description
      </TabItem>
    </Tabs>
  </TabItem>
</Tabs>

[rolznz]

@blackgirlbytes thanks, I've applied your suggestion and it feels a lot cleaner.

[blackgirlbytes]

awesome! I approved. Running your tests now.

[rolznz]

@blackgirlbytes one of the checks failed but I think it's unrelated to the change? could you re-run it?

[blackgirlbytes]

@blackgirlbytes one of the checks failed but I think it's unrelated to the change? could you re-run it?

Yes re running the check now! @rolznz . If it fails again, you may have to rebase . Let's see

[blackgirlbytes]

Thank you. It's a US holiday when @agiuliano-square returns, we can approve and merge. Apologies!