validate_address

Verify Bitcoin address validity to prevent errors in transactions and ensure proper format before use.

Instructions

Validate a Bitcoin address

Input Schema

TableJSON Schema

Name	Required	Description	Default
`address`	Yes	The Bitcoin address to validate

Implementation Reference

src/server/tools.ts:73-96 (handler)

The main handler function for the 'validate_address' tool. It parses input arguments using ValidateAddressSchema, calls bitcoinService.validateAddress, and returns a text response indicating validity.

export async function handleValidateAddress(
  bitcoinService: BitcoinService,
  args: unknown
) {
  const result = ValidateAddressSchema.safeParse(args);
  if (!result.success) {
    throw new McpError(
      ErrorCode.InvalidParams,
      `Invalid parameters: ${result.error.message}`
    );
  }

  const isValid = bitcoinService.validateAddress(result.data.address);
  return {
    content: [
      {
        type: "text",
        text: isValid
          ? `Address ${result.data.address} is valid`
          : `Address ${result.data.address} is invalid`,
      },
    ] as TextContent[],
  };
}

src/types.ts:118-120 (schema)
Zod schema defining the input for the validate_address tool: an object with a required 'address' string.
```
export const ValidateAddressSchema = z.object({
  address: z.string().min(1, "Address is required"),
});
```

src/server/base.ts:122-134 (registration)

Tool registration in the MCP server's listTools response, specifying name 'validate_address', description, and input schema.

  name: "validate_address",
  description: "Validate a Bitcoin address",
  inputSchema: {
    type: "object",
    properties: {
      address: {
        type: "string",
        description: "The Bitcoin address to validate",
      },
    },
    required: ["address"],
  } as any,
} as Tool,

src/server/base.ts:203-205 (registration)
Dispatch logic in the callTool request handler that routes 'validate_address' calls to handleValidateAddress.
```
case "validate_address": {
  return handleValidateAddress(this.bitcoinService, args);
}
```

src/services/bitcoin.ts:114-121 (helper)

Core helper method in BitcoinService that performs the actual address validation using bitcoinjs-lib's toOutputScript.

validateAddress(address: string): boolean {
  try {
    bitcoin.address.toOutputScript(address, this.network);
    return true;
  } catch {
    return false;
  }
}

Bitcoin MCP Server