Skip to content

Add Bitcoin Knowledge Base (bkb-mcp) extension#8036

Open
tnull wants to merge 2 commits intoblock:mainfrom
tnull:2026-03-add-bkb
Open

Add Bitcoin Knowledge Base (bkb-mcp) extension#8036
tnull wants to merge 2 commits intoblock:mainfrom
tnull:2026-03-add-bkb

Conversation

@tnull
Copy link

@tnull tnull commented Mar 20, 2026

Summary

  • Add bkb-mcp as a community extension to Goose
  • bkb-mcp is an MCP server for the Bitcoin Knowledge Base — a search and reference tool that indexes the Bitcoin and Lightning development ecosystem across BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs/commits, mailing lists, IRC logs,
    Delving Bitcoin, BitcoinTalk, and Optech newsletters
  • Adds registry entry in servers.json and a documentation page at docs/mcp/bkb-mcp

Available tools

Tool Description
bkb_search Full-text search across all indexed resources
bkb_get_document Retrieve a specific document by ID
bkb_get_references Get references and citations for a document
bkb_lookup_bip Look up a BIP by number
bkb_lookup_bolt Look up a BOLT by number
bkb_lookup_blip Look up a bLIP by number
bkb_lookup_lud Look up a LUD by number
bkb_lookup_nut Look up a NUT by number
bkb_timeline Get a timeline of events for a topic
bkb_find_commit Find relevant commits across Bitcoin-related repositories

Test plan

  • npm run build in documentation/ succeeds
  • New page renders at /docs/mcp/bkb-mcp
  • Extension appears in the extensions page (from servers.json)
  • Deep link URL correctly opens the installer

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 47a35d7834

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

tnull added 2 commits March 20, 2026 16:35
Mark `BKB_API_URL` as required since the upstream binary defaults to
`http://127.0.0.1:3000`, not the public hosted API.

Co-Authored-By: HAL 9000
Signed-off-by: Elias Rohrer <dev@tnull.de>
Add `BKB_API_URL` env var to CLI instructions and clarify that the
variable is required, with the public API at
\`https://bitcoinknowledge.dev\` as the recommended value.

Co-Authored-By: HAL 9000
Signed-off-by: Elias Rohrer <dev@tnull.de>
@tnull tnull force-pushed the 2026-03-add-bkb branch from 47a35d7 to 0bc6e01 Compare March 20, 2026 15:35
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0bc6e011f6

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

"id": "bkb-mcp",
"name": "Bitcoin Knowledge Base",
"description": "Search and reference tool for Bitcoin and Lightning development — indexes BIPs, BOLTs, bLIPs, LUDs, NUTs, GitHub issues/PRs, mailing lists, and more",
"command": "bkb-mcp",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Use a deeplink-safe command for Desktop installation

This registry entry advertises cmd=bkb-mcp, but Desktop deeplinks reject any stdio command outside the hard-coded allowlist in ui/desktop/src/components/settings/extensions/deeplink.ts:getStdioConfig (cu, docker, jbang, npx, uvx, goosed, npx.cmd, i-ching-mcp-server). Because the Extensions page builds its install URL directly from servers.json via documentation/src/utils/install-links.ts, clicking Install for this new extension will raise Invalid command instead of opening the add-extension flow, so Desktop users cannot install it through the advertised one-click path.

Useful? React with 👍 / 👎.


:::tip Quick Install
1. Install: `cargo install bkb-mcp`
2. Configure: [Add BKB Extension](goose://extension?cmd=bkb-mcp&id=bkb-mcp&name=Bitcoin%20Knowledge%20Base&description=Search%20and%20reference%20tool%20for%20Bitcoin%20and%20Lightning%20development)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include BKB_API_URL in the quick-install deeplink

The quick-install link omits any env= parameter even though this page’s UI/CLI sections and servers.json both treat BKB_API_URL as required. In Desktop, deeplinks without env vars are installed immediately instead of opening the env-var modal (ui/desktop/src/components/settings/extensions/deeplink.ts:addExtensionFromDeepLink), so a reader who follows this 2-step quick start gets a bkb-mcp config that never prompts for the API URL and falls back to the server’s localhost default unless they are self-hosting BKB.

Useful? React with 👍 / 👎.

@DOsinga DOsinga added the needs_human label to set when a robot looks at a PR and can't handle it label Mar 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs_human label to set when a robot looks at a PR and can't handle it

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants