Mempool MCP Server

Instructions

Implementation Reference

• src/infrastructure/services/requests/BlocksRequestService.ts:32-34 (handler)

  Core handler implementation that performs the actual API request to retrieve the txid by index using the client.

  async getBlockTxidByIndex({ hash, index }: { hash: string; index: number }): Promise<string | null> {
    return this.client.makeRequest<string>(`block/${hash}/txid/${index}`);
  }

• src/application/services/BlocksService.ts:39-48 (helper)

  Helper wrapper in BlocksService that calls the request service and formats the response text.

  async getBlockTxidByIndex({
    hash,
    index,
  }: {
    hash: string;
    index: number;
  }): Promise<string> {
    const data = await this.requestService.getBlockTxidByIndex({ hash, index });
    return `Block Txid By Index: ${data}`;
  }

• src/interface/controllers/BlocksToolsController.ts:93-96 (schema)

  Zod schema defining the input parameters for the tool: hash (64-char string) and index (integer).

  {
    hash: z.string().length(64).describe("The block hash to get txid for"),
    index: z.number().int().describe("The index of the txid in the block"),
  },

• src/interface/controllers/BlocksToolsController.ts:89-102 (registration)

  Registers the 'get-block-txid-by-index' tool with the MCP server, including description, schema, and thin handler delegating to BlocksService.

  private registerGetBlockTxidByIndexHandler(): void {
    this.server.tool(
      "get-block-txid-by-index",
      "Returns txid for a block at a specific index",
      {
        hash: z.string().length(64).describe("The block hash to get txid for"),
        index: z.number().int().describe("The index of the txid in the block"),
      },
      async ({ hash, index }) => {
        const text = await this.blocksService.getBlockTxidByIndex({ hash, index });
        return { content: [{ type: "text", text }] };
      }
    );
  }