Copy any of these into your AI agent to see what BKB can do.
These prompts work with any MCP-capable AI agent (e.g., Claude Code, Claude Desktop) that has the bkb-mcp server configured. The agent will automatically call the right BKB tools to answer the question.
Understanding Specifications
Explain BIP-340 (Schnorr signatures) to me. What problem does it solve, what discussions led to its design, and which implementations reference it?
Looks up the BIP spec, gathers cross-references from GitHub PRs, mailing list threads, and Optech coverage to build a complete picture.
bkb_lookup_bipbkb_get_references
Compare BOLT-11 and BOLT-12 invoices. What are the key differences, and what was the motivation for BOLT 12?
Retrieves both BOLT specs and searches for related discussions to synthesize a comparison.
bkb_lookup_boltbkb_search
What is bLIP-39? Summarize the proposal and show me any PRs that implement it.
Fetches the bLIP spec text and finds referencing implementation PRs across Lightning repos.
bkb_lookup_blipbkb_get_references
Researching a Concept End-to-End
Give me a timeline of how Taproot went from proposal to activation. Include mailing list posts, BIPs, key PRs, and Optech coverage.
Uses the timeline tool to trace the full chronological history of a concept across all sources.
bkb_timelinebkb_lookup_bipbkb_get_document
What is package relay, why does Bitcoin Core need it, and what's the current status? Show me the most important discussions and PRs.
Combines timeline, search, and document retrieval to produce a research summary with primary sources.
bkb_timelinebkb_searchbkb_get_document
Trace the history of channel jamming mitigations in the Lightning Network. What approaches have been proposed on the mailing list and Delving Bitcoin?
Searches across mailing lists and Delving Bitcoin filtered by topic, then follows up on key threads.
bkb_timelinebkb_search
Investigating Code Changes
Find the PR that added MuSig2 support to rust-bitcoin and summarize the discussion around it.
Searches for commits/PRs matching the description in a specific repo, then retrieves the full document with comments.
bkb_find_commitbkb_get_document
What changes were made to LDK's channel management code in Q4 2024? List the major PRs.
Uses wildcard search with repo and date filters to find all matching PRs in a time window.
bkb_search
Show me all the PRs that reference or fix issue bitcoin/bitcoin#25038.
Finds all documents that cross-reference a specific issue, including “Fixes” and “Closes” links.
bkb_get_referencesbkb_get_document
Cross-Source Research
What has BlueMatt written about across the Bitcoin ecosystem? Show me his mailing list posts, GitHub PRs, and Delving Bitcoin topics.
Searches with an author filter across all source types to build an author profile.
bkb_search
Find all discussions about covenant proposals (OP_CTV, OP_CAT, TXHASH) across the mailing list, Delving Bitcoin, and IRC. What are the main camps and arguments?
Runs multiple targeted searches and retrieves key documents to synthesize a balanced overview.
bkb_searchbkb_get_documentbkb_timeline
Summarize this week's Optech newsletter and link me to the primary sources it references.
Searches for the latest Optech newsletter, then follows BIP/BOLT/PR references to their source documents.
bkb_searchbkb_get_documentbkb_get_references
Quick Lookups
What does BIP-141 specify?
Straight spec lookup — returns the BIP content and a list of documents that reference it.
bkb_lookup_bip
Find IRC discussions about assumeUTXO from the last 6 months.
Targeted search with source type and date filters.
bkb_search
Look up the trampoline routing commit in Eclair.
Finds the specific commit with associated PR context in a Lightning implementation.
bkb_find_commit
