Bitcoin MCP Server

Instructions

Implementation Reference

• src/server/tools.ts:52-62 (handler)

  The main handler function for the 'generate_key' tool. It calls BitcoinService.generateKey() and formats the response as MCP TextContent.

  export async function handleGenerateKey(bitcoinService: BitcoinService) {
    const key = await bitcoinService.generateKey();
    return {
      content: [
        {
          type: "text",
          text: `Generated new Bitcoin key pair:\nAddress: ${key.address}\nPrivate Key (WIF): ${key.privateKey}\nPublic Key: ${key.publicKey}`,
        },
      ] as TextContent[],
    };
  }

• src/server/base.ts:116-120 (registration)

  Registration of the 'generate_key' tool in the ListToolsRequestSchema handler, including name, description, and empty input schema.

  {
    name: "generate_key",
    description: "Generate a new Bitcoin key pair and address",
    inputSchema: { type: "object", properties: {}, required: [] },
  } as Tool,

• src/server/base.ts:200-202 (handler)

  Dispatch logic in the CallToolRequestSchema handler that routes 'generate_key' calls to handleGenerateKey.

  case "generate_key": {
    return handleGenerateKey(this.bitcoinService);
  }

• src/services/bitcoin.ts:79-103 (helper)

  Core implementation of key generation using bitcoinjs-lib, producing address, WIF private key, and hex public key.

  async generateKey(): Promise<GeneratedKey> {
    try {
      const keyPair = ECPair.makeRandom({ rng });
      const { address } = bitcoin.payments.p2pkh({
        pubkey: keyPair.publicKey,
        network: this.network,
      });
  
      if (!address) {
        throw new Error("Failed to generate address");
      }
  
      return {
        address,
        privateKey: keyPair.toWIF(),
        publicKey: keyPair.publicKey.toString("hex"),
      };
    } catch (error) {
      logger.error({ error }, "Failed to generate key");
      throw new BitcoinError(
        "Failed to generate key pair",
        BitcoinErrorCode.KEY_GENERATION_ERROR
      );
    }
  }